API লিঙ্ক করা

ভূমিকা

লিঙ্কিং এপিআই একটি ইউআরএলের মাধ্যমে ব্যবহারকারীদের সরাসরি লুকার স্টুডিও রিপোর্টে কনফিগার এবং ফরওয়ার্ড করার জন্য একটি নির্ভরযোগ্য ইন্টারফেস প্রদান করে। ব্যবহারকারীরা যখন একটি লিঙ্কিং API URL অনুসরণ করে তখন তাদের ডেটা দ্রুত দেখতে এবং ইন্টারঅ্যাক্ট করার জন্য তাদের একটি সুগমিত অভিজ্ঞতা থাকবে।

এই দস্তাবেজটি API URL লিঙ্ক করার প্রয়োজনীয় বিন্যাস এবং উপলব্ধ পরামিতিগুলি বর্ণনা করে৷

কেস এবং সুবিধা ব্যবহার করুন

লিঙ্কিং API আপনার গ্রাহকদের তাদের ডেটা দেখতে এবং ইন্টারঅ্যাক্ট করার জন্য পূর্ব-কনফিগার করা রিপোর্ট প্রদান করতে ব্যবহার করা যেতে পারে। লিঙ্কিং API এর মূল সুবিধাগুলি নিম্নরূপ:

• আপনার গ্রাহকদের জন্য একটি এক-ক্লিক রিপোর্ট তৈরির অভিজ্ঞতা ।
  • ইউআরএলে ডেটা কনফিগারেশন দেওয়া হয়েছে তাই ব্যবহারকারীদের তাদের ডেটার জন্য রিপোর্ট কনফিগার করতে হবে না।
  • ব্যবহারকারীরা একটি একক ক্লিকে প্রতিবেদনটি সংরক্ষণ করতে পারেন এবং যে কোনো সময় প্রতিবেদনটি পুনরায় দেখতে পারেন।
• স্কেলে রিপোর্ট তৈরি করুন । লিঙ্কিং এপিআই নকল বা নতুন প্রতিবেদন তৈরি করার জন্য প্রয়োজনীয় সময় কমিয়ে দেয়।
• পণ্য ইন্টিগ্রেশন সক্রিয় করুন . স্থিতিশীল ইন্টারফেস আপনাকে একটি পণ্য কর্মপ্রবাহে লুকার স্টুডিওকে একীভূত করতে দেয়।

কিভাবে এটা কাজ করে

নিম্নলিখিত বর্ণনা করে কিভাবে বিকাশকারী এবং ব্যবহারকারীরা লিঙ্কিং API এর সাথে যোগাযোগ করে।

API ডেভেলপার ওয়ার্কফ্লো লিঙ্ক করা

বিকাশকারী টেমপ্লেট রিপোর্ট, ডেটা উত্স প্রস্তুত করে এবং একটি লিঙ্কিং API URL ফর্ম্যাট করে। বিকাশকারীদের জন্য সাধারণ কর্মপ্রবাহ নিম্নরূপ:

1. একটি ফাঁকা প্রতিবেদন, লুকার স্টুডিও দ্বারা প্রদত্ত ডিফল্ট রিপোর্ট টেমপ্লেট ব্যবহার করবেন কিনা বা একটি টেমপ্লেট হিসাবে কাজ করবে এমন একটি লুকার স্টুডিও প্রতিবেদন তৈরি করবেন কিনা তা নির্ধারণ করুন৷ এর মধ্যে রয়েছে টেমপ্লেট ডেটা উৎস কনফিগার করা।
2. আপনার নির্দিষ্ট ব্যবহারের ক্ষেত্রে একটি লিঙ্কিং API URL ফর্ম্যাট করুন। প্রযোজ্য হলে, রিপোর্ট টেমপ্লেট এবং রিপোর্টের নাম, ডেটা সোর্স নাম এবং ডেটা সোর্স কনফিগারেশন সহ অন্যান্য প্যারামিটার উল্লেখ করুন।
3. ব্যবহারকারীদের রিপোর্টে নির্দেশিত করতে লিঙ্কিং API URL ব্যবহার করুন।

API ব্যবহারকারীর অভিজ্ঞতা লিঙ্ক করা

ব্যবহারকারী একটি লিঙ্কিং এপিআই ইউআরএল অনুসরণ করে, যা ডেভেলপার দ্বারা সঠিকভাবে কনফিগার করা হলে, তাদের একটি লুকার স্টুডিও রিপোর্টে নির্দেশিত করবে যা তাদের অ্যাক্সেসের ডেটা দেখতে এবং ইন্টারঅ্যাক্ট করতে দেয়। একটি সাধারণ ব্যবহারকারীর অভিজ্ঞতা নিম্নরূপ হতে পারে:

1. একটি ব্রাউজারে, ব্যবহারকারী এমন একটি পরিষেবা পরিদর্শন করে যা লিঙ্কিং API এর সাথে একত্রিত হয়েছে।
2. একটি কল টু অ্যাকশন ব্যবহারকারীকে লুকার স্টুডিওতে তাদের ডেটা দেখতে একটি লিঙ্কে ক্লিক করার জন্য আমন্ত্রণ জানায়।
3. ব্যবহারকারী লিঙ্কটি অনুসরণ করে এবং একটি লুকার স্টুডিও রিপোর্টে নির্দেশিত হয়। রিপোর্ট লোড হয় এবং ব্যবহারকারী তাদের ডেটা দেখতে এবং ইন্টারঅ্যাক্ট করতে সক্ষম হয়।
4. ব্যবহারকারী "সম্পাদনা করুন এবং ভাগ করুন" ক্লিক করেন। প্রতিবেদনটি তাদের লুকার স্টুডিও অ্যাকাউন্টে সংরক্ষণ করা হয়েছে।
5. ব্যবহারকারীর এখন সম্পূর্ণ অ্যাক্সেস এবং রিপোর্টের নিজস্ব অনুলিপির উপর নিয়ন্ত্রণ রয়েছে। তারা যে কোন সময় দেখতে, সম্পাদনা করতে এবং শেয়ার করতে পারে।

প্রয়োজনীয়তা

একটি লিঙ্কিং API URL আশানুরূপ কাজ করে তা নিশ্চিত করতে, নিম্নলিখিত প্রয়োজন:

1. একটি রিপোর্ট, একটি টেমপ্লেট হিসাবে পরিবেশন করা. যদি প্রদান না করা হয় তাহলে লুকার স্টুডিও দ্বারা প্রদত্ত একটি ফাঁকা প্রতিবেদন বা ডিফল্ট প্রতিবেদন ব্যবহার করা যেতে পারে।
2. লিঙ্কিং এপিআই ইউআরএল ব্যবহারকারীদের ন্যূনতম টেমপ্লেট রিপোর্ট দেখার অ্যাক্সেস থাকতে হবে। প্রতিবেদনে ব্যবহৃত ডেটা উৎসের ধরন এবং লিঙ্কিং এপিআই-এর মাধ্যমে প্রদত্ত কনফিগারেশনের উপর নির্ভর করে, ব্যবহারকারীদের ডেটা উত্সগুলি দেখার অ্যাক্সেসেরও প্রয়োজন হতে পারে। বিস্তারিত জানার জন্য টেমপ্লেট অনুমতি দেখুন।
3. প্রতিটি ডেটা উত্সের সংযোগকারী প্রকার অবশ্যই লিঙ্কিং API এর মাধ্যমে কনফিগারেশন সমর্থন করবে৷ সমর্থিত সংযোগকারীর তালিকার জন্য সংযোগকারী রেফারেন্স পড়ুন।
4. লিঙ্কিং API URL-এর ব্যবহারকারীদের অবশ্যই লিঙ্কিং API URL-এ কনফিগার করা ডেটাতে অ্যাক্সেস থাকতে হবে। যদি ব্যবহারকারীর অন্তর্নিহিত ডেটাতে অ্যাক্সেস না থাকে, তবে কোনো নির্ভরশীল রিপোর্ট উপাদান একটি ত্রুটি দেখাবে।

দ্রষ্টব্য: লিঙ্কিং API বিদ্যমান ডেটা অ্যাক্সেস, শেয়ারিং সেটিংস বা মূল রিপোর্ট টেমপ্লেট এবং ডেটা উত্স কনফিগারেশন পরিবর্তন করে না।

URL প্যারামিটার

একটি লিঙ্কিং API URL নিম্নলিখিত ফর্মের হতে হবে:

https://lookerstudio.google.com/reporting/create?parameters

ইউআরএলটি একটি ওয়েব ব্রাউজারের প্রেক্ষাপটে ব্যবহার করা হবে বলে আশা করা হচ্ছে, সাধারণত একজন ব্যবহারকারী একটি লিঙ্কে ক্লিক করে বা URL-এ পুনঃনির্দেশিত হয়। এটি একটি প্রতিবেদন এম্বেড করতেও ব্যবহার করা যেতে পারে।

উদাহরণ URL

নিম্নলিখিত একটি উদাহরণ লিঙ্ক API URL. রিপোর্টের নাম সেট করা হয়েছে এবং একটি একক BigQuery ডেটা উৎস কনফিগার করা হয়েছে:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.connector=bigQuery
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

দ্রষ্টব্য: এটি ইউআরএল-এনকোড প্যারামিটারের জন্য সুপারিশ করা হয়। একটি বৈধ URL তৈরির বিশদ বিবরণের জন্য URL এনকোডিং দেখুন।

কিছু URL প্যারামিটার প্রয়োজন, কিছু ঐচ্ছিক। নিম্নলিখিত একটি লিঙ্কিং API URL সংজ্ঞায়িত করতে ব্যবহৃত পরামিতিগুলির একটি তালিকা:

নিয়ন্ত্রণ পরামিতি

লিঙ্কিং API URL-এর মাধ্যমে দেখা হলে কন্ট্রোল প্যারামিটার রিপোর্টের অবস্থা নির্ধারণ করে।

পরামিতি নাম	বর্ণনা
c.reportId	ঐচ্ছিক। টেমপ্লেট রিপোর্ট আইডি। Looker Studio খুলবে এবং নির্দিষ্ট করা রিপোর্ট কনফিগার করবে। কীভাবে আইডি খুঁজে পাবেন তার বিস্তারিত জানার জন্য, রিপোর্ট আইডি দেখুন। অনির্দিষ্ট থাকলে, একটি ফাঁকা প্রতিবেদন বা ডিফল্ট রিপোর্ট টেমপ্লেট ব্যবহার করা হয়, বিস্তারিত জানার জন্য একটি ফাঁকা বা ডিফল্ট প্রতিবেদন ব্যবহার করুন দেখুন।
c.pageId	ঐচ্ছিক। রিপোর্টে লোড করার জন্য প্রাথমিক পৃষ্ঠার আইডি। অনির্দিষ্ট থাকলে রিপোর্টের প্রথম পৃষ্ঠায় ডিফল্ট, .
c.mode	ঐচ্ছিক। প্রাথমিক রিপোর্ট মোড. একটি view বা edit । অনির্দিষ্ট থাকলে view ডিফল্ট।
c.explain ব্যাখ্যা করুন	ঐচ্ছিক। তথ্য/ডিবাগ ডায়ালগের দৃশ্যমানতা। ডায়ালগ বোতাম দেখানোর জন্য true সেট করুন। অনির্দিষ্ট থাকলে ডিফল্ট false । আরও জানতে কনফিগারেশন সমস্যা সমাধানের সমস্যা দেখুন।

উদাহরণ

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &c.pageId=g7u8s9
  &c.mode=edit
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

রিপোর্ট পরামিতি

রিপোর্ট প্যারামিটার রিপোর্ট বৈশিষ্ট্য ওভাররাইড.

পরামিতি নাম	বর্ণনা
r.reportName	ঐচ্ছিক। রিপোর্টের নাম সেট করে। অনির্দিষ্ট থাকলে, টেমপ্লেট রিপোর্ট নামের ডিফল্ট।
r.measurementId	ঐচ্ছিক। রিপোর্টের ব্যবহার পরিমাপ করতে Google Analytics পরিমাপ আইডি সেট করে। একাধিক আইডি আলাদা করতে একটি কমা ব্যবহার করুন। r.measurementId এবং r.keepMeasurementId অনির্দিষ্ট থাকলে, Google Analytics পরিমাপ আইডি রিপোর্ট ডিফল্ট সেটিং আনসেট করে। r.measurementId এবং r.keepMeasurementId সেট করা থাকলে, r.keepMeasurementId আইডি সেট করতে অগ্রাধিকার নেয়।
r.keepMeasurementId	ঐচ্ছিক। টেমপ্লেট রিপোর্ট Google Analytics পরিমাপ আইডি ব্যবহার করতে true সেট করুন। অনির্দিষ্ট থাকলে ডিফল্ট false । r.measurementId এবং r.keepMeasurementId অনির্দিষ্ট থাকলে, Google Analytics পরিমাপ আইডি রিপোর্ট ডিফল্ট সেটিং আনসেট করে। r.measurementId এবং r.keepMeasurementId সেট করা থাকলে, r.keepMeasurementId আইডি সেট করতে অগ্রাধিকার নেয়।

উদাহরণ

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &r.measurementId=G-XXXXXXXXXX
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

ডাটা সোর্স প্যারামিটার

ডেটা সোর্স প্যারামিটার আপনাকে ডেটা সোর্স কনফিগারেশন এবং টেমপ্লেট রিপোর্টে ডেটা সোর্স অ্যাক্সেস করার জন্য ডেটা নির্ধারণ করতে দেয়।

একটি alias একটি বিদ্যমান প্রতিবেদনে একটি ডেটা উৎস উল্লেখ করতে ব্যবহৃত হয়। যদি টেমপ্লেট রিপোর্ট থেকে কোনো ডেটা উৎস যোগ/মুছে ফেলা হয় তাহলে উপনাম ব্যবহার করলে পিছনের সামঞ্জস্যের জন্য অনুমতি দেওয়া হয়।

কিভাবে একটি ডেটা উৎস alias খুঁজে বের করতে হয় তার বিস্তারিত জানার জন্য, ডেটা উৎস উপনাম দেখুন।

দ্রষ্টব্য: যদি টেমপ্লেট রিপোর্টে একটি একক ডেটা উত্স থাকে, তবে একটি ডেটা উত্স উপনাম কঠোরভাবে প্রয়োজন হয় না। যাইহোক, একটি লিঙ্কিং API URL এবং সংশ্লিষ্ট ডেটা উত্সগুলি পরিদর্শন করার সময় ডেটা উত্স কনফিগারেশনগুলিকে দ্ব্যর্থিত করতে সাহায্য করার জন্য উপনামটি নির্দিষ্ট করার পরামর্শ দেওয়া হয়৷

ডাটা সোর্স প্যারামিটার

নিম্নলিখিত পরামিতিগুলি সমস্ত সংযোগকারী প্রকারগুলিতে সাধারণ:

নাম	বর্ণনা
ds. alias .datasourceName	ঐচ্ছিক। ডেটা উৎসের নাম সেট করে। যদি ds.datasourceName এবং ds.keepDatasourceName অনির্দিষ্ট থাকে, তাহলে ডেটা উৎসের নাম একটি নামকরণের নিয়মে ডিফল্ট হয় যাতে সংযোগকারীর ধরন এবং সৃষ্টির সময় অন্তর্ভুক্ত থাকে (যেমন নমুনা - 12/12/21, 10:53 PM )। ds.datasourceName এবং ds.keepDatasourceName সেট করা থাকলে, ডেটা উৎসের নাম সেট করতে ds.datasourceName অগ্রাধিকার নেয়।
ds. alias .keepDatasourceName	ঐচ্ছিক। টেমপ্লেট ডেটা উৎসের নাম ব্যবহার করতে true সেট করুন। অনির্দিষ্ট থাকলে ডিফল্ট false । যদি ds.datasourceName এবং ds.keepDatasourceName অনির্দিষ্ট থাকে, তাহলে ডেটা উৎসের নাম একটি নামকরণের নিয়মে ডিফল্ট হয় যাতে সংযোগকারীর ধরন এবং সৃষ্টির সময় অন্তর্ভুক্ত থাকে (যেমন নমুনা - 12/12/21, 10:53 PM )। ds.datasourceName এবং ds.keepDatasourceName সেট করা থাকলে, ডেটা উৎসের নাম সেট করতে ds.datasourceName অগ্রাধিকার নেয়।
ds. alias .connector	ঐচ্ছিক। ডেটা উৎসের সংযোগকারী প্রকার। সমর্থিত সংযোগকারী প্রকার সম্পর্কে আরও তথ্যের জন্য, সংযোগকারীর রেফারেন্স দেখুন। যদি সেট করা থাকে তাহলে সংযোগকারী প্রকারের জন্য সমস্ত প্রয়োজনীয় সংযোগকারী পরামিতি অবশ্যই লিঙ্কিং API URL-এ নির্দিষ্ট করতে হবে এবং টেমপ্লেট ডেটা উৎস কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপিত হবে। যদি অনির্দিষ্ট থাকে, তাহলে সংযোগকারী প্রকারের জন্য শূন্য বা তার বেশি সংযোগকারী পরামিতি লিঙ্কিং API URL-এ নির্দিষ্ট করা যেতে পারে। টেমপ্লেট ডেটা সোর্স কনফিগারেশন লিঙ্কিং এপিআই ইউআরএলে দেওয়া নেই এমন কোনো প্যারামিটার নির্দিষ্ট করতে ব্যবহার করা হবে। টেমপ্লেট ডেটা উৎসের সংযোগকারীর ধরন কীভাবে সনাক্ত করা যায় তার বিশদ বিবরণের জন্য, সংযোগকারীর প্রকার দেখুন। একটি টেমপ্লেট ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপিত হয় বা অনির্দিষ্ট প্যারামিটার আপডেট করতে ব্যবহৃত হয় কিনা ds.connector প্যারামিটার কীভাবে প্রভাবিত করে সে সম্পর্কে আরও জানতে, প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .refreshFields	ঐচ্ছিক। ডেটা সোর্স ফিল্ড রিফ্রেশ করতে এবং নতুন ফিল্ড নির্বাচনের সাথে রিপোর্ট উপাদান আপডেট করতে লিঙ্কিং API-এর মাধ্যমে নির্দিষ্ট ডেটা সোর্স কনফিগারেশন ব্যবহার করতে true সেট করুন। true সাধারণত কানেক্টরের ধরন পরিবর্তন করার সময় বা সংযোগকারীর প্রকারের জন্য নির্দিষ্ট করা হয় যেখানে একটি কনফিগারেশন পরিবর্তন বিভিন্ন ক্ষেত্র তৈরি করে (যেমন BigQuery ডেটা উৎসের জন্য ক্ষেত্রগুলি প্রায়শই বিভিন্ন টেবিল কনফিগারেশনের সাথে পরিবর্তিত হয়)। টেমপ্লেট রিপোর্ট থেকে ডেটা উৎস ক্ষেত্রগুলি অপরিবর্তিত রাখতে false সেট করুন। false সাধারণত নির্দিষ্ট করা হয় যখন নতুন ডেটা কনফিগারেশনে একই ক্ষেত্র পাওয়া যায় এবং আপনি টেমপ্লেট ডেটা উৎসে করা যেকোনো ক্ষেত্রের পরিবর্তন বজায় রাখতে পছন্দ করবেন। অনির্দিষ্ট থাকলে, সংযোগকারীর ধরন অনুসারে ডিফল্ট পরিবর্তিত হয়। আপনি যদি ডিফল্ট আচরণ ওভাররাইড করতে চান তাহলে সংযোগকারী নির্দিষ্ট ডিফল্টের জন্য সংযোগকারীর রেফারেন্স পর্যালোচনা করুন। refreshFields ব্যবহার করার সময় বিবেচ্য বিষয়গুলি: যদি refreshFields false সেট করা থাকে এবং লিঙ্কিং এপিআই-এর মাধ্যমে নির্দিষ্ট করা ডেটা উৎস কনফিগারেশন টেমপ্লেট রিপোর্টে যা ব্যবহার করা হয়েছে তার থেকে ভিন্ন ক্ষেত্র পাওয়া যায়, ব্যবহারকারী সম্ভবত প্রভাবিত উপাদানগুলির জন্য একটি কনফিগারেশন ত্রুটি দেখতে পাবেন। টেমপ্লেট ডেটা উত্সের ক্ষেত্রের পরিবর্তনগুলি (যেমন নাম, প্রকার, একত্রীকরণ, ইত্যাদি) নতুন ডেটা উত্সগুলিতে বহন করে না যখন refreshFields true সেট করা হয়। টেমপ্লেট ডেটা উৎস থেকে ফিল্ড কনফিগারেশন বজায় রাখার জন্য refreshFields false সেট করুন। টেমপ্লেট ডেটা উত্সগুলিতে সংজ্ঞায়িত গণনা করা ক্ষেত্র এবং পরামিতিগুলি সর্বদা নতুন তৈরি ডেটা উত্সগুলিতে অনুলিপি করা হবে এবং refreshFields মান দ্বারা প্রভাবিত হবে না৷
ds. alias .connectorParameters	প্রয়োজন সংযোগকারী প্রকারের জন্য ডেটা উৎস কনফিগারেশন। একটি ডেটা উত্স তৈরি করতে ব্যবহৃত সংযোগকারীকে কীভাবে সনাক্ত করতে হয় তার বিশদ বিবরণের জন্য, সংযোগকারীর প্রকার দেখুন। প্রতিটি সংযোগকারী প্রকারের জন্য উপলব্ধ ডেটা উত্স পরামিতিগুলির বিশদ বিবরণের জন্য, সংযোগকারীর রেফারেন্স দেখুন।

প্রতিস্থাপন বনাম আপডেট - ডেটা উৎস কনফিগারেশন

ডেটা সোর্স প্যারামিটার সেট করার সময়, লিঙ্কিং API URL-এ ds.connector প্যারামিটারের উপস্থিতি বা বাদ দেওয়া যথাক্রমে টেমপ্লেট ডেটা সোর্স কনফিগারেশন প্রতিস্থাপন বা আপডেট করার অভিপ্রায় নির্দেশ করে।

একটি টেমপ্লেট ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপিত হয় বা অনির্দিষ্ট পরামিতি আপডেট করতে ব্যবহৃত হয় কিনা তা ds.connector প্যারামিটার কীভাবে প্রভাবিত করে তা নিম্নলিখিত সারণীতে রয়েছে:

ds.connector সেট করা আছে?	প্রত্যাশিত কনফিগারেশন এবং আচরণ	সাধারণ ব্যবহার
হ্যাঁ	প্রতিস্থাপন করুন । টেমপ্লেট ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপিত হয়, লিঙ্কিং API URL-এ নির্দিষ্ট ডেটা সোর্স প্যারামিটার ব্যবহার করে। সংযোগকারী প্রকারের জন্য আপনাকে অবশ্যই সমস্ত প্রয়োজনীয় পরামিতি নির্দিষ্ট করতে হবে। ds.connector সেট করা হলে প্রয়োজনীয় প্যারামিটার দেখুন।	একটি ডেটা উৎসের সংযোগকারী প্রকার পরিবর্তন করার সময়। যেমন আপনি যদি টেমপ্লেট রিপোর্টে একটি BigQuery ডেটা উৎস কনফিগার করেন কিন্তু Linking API-এর মাধ্যমে একটি Sheets ডেটা উৎস কনফিগার করতে চান। এটি সম্পূর্ণরূপে সংজ্ঞায়িত করার জন্য একটি নতুন সংযোগকারী কনফিগারেশন প্রয়োজন হবে। যখন আপনি একটি ডেটা উৎসের কনফিগারেশনের গ্যারান্টি দিতে চান। কনফিগারেশন প্রতিস্থাপন করা টেমপ্লেট ডেটা উৎস থেকে সম্ভাব্যভাবে ব্যবহৃত কোনো অজানা মান এড়িয়ে যায়।
না	আপডেট টেমপ্লেট ডেটা সোর্স কনফিগারেশন লিঙ্কিং এপিআই ইউআরএলে দেওয়া নেই এমন কোনো প্যারামিটার নির্দিষ্ট করতে ব্যবহার করা হবে। সংযোগকারী প্রকারের জন্য সমস্ত সংযোগকারী পরামিতি ঐচ্ছিক, যদি না অন্যথায় বলা হয়। এটি লিঙ্কিং API URL-কে সহজ করে এবং সাধারণত সুপারিশ করা হয় যখন আপনি টেমপ্লেট ডেটা উৎস কনফিগারেশনের সাথে পরিচিত হন এবং শুধুমাত্র প্যারামিটারের একটি উপসেট ওভাররাইড করতে চান।	যখন আপনি শুধুমাত্র প্যারামিটার মান প্রদান করতে চান যা টেমপ্লেট ডেটা উৎস থেকে আলাদা এবং যেকোনো অনির্দিষ্ট সংযোগকারী পরামিতির জন্য টেমপ্লেট ডেটা উৎসের উপর নির্ভর করে ঠিক আছে। যেমন BigQuery ডেটা সোর্স কনফিগারেশনের শুধুমাত্র বিলিং প্রোজেক্ট আইডি পরিবর্তন করুন এবং অন্য সব প্যারামিটারের জন্য টেমপ্লেট কনফিগারেশন ব্যবহার করুন।

ds.connector সেট করা হলে প্রয়োজনীয় পরামিতি

যদি একটি ডেটা উৎসের ds.connector পরামিতি নির্দিষ্ট করা থাকে, তাহলে প্রয়োজনীয় হিসাবে মনোনীত সমস্ত সংযোগকারী পরামিতি ডেটা উত্সের জন্য নির্দিষ্ট করা আবশ্যক৷ যদি ডেটা উৎসের ds.connector পরামিতি অনির্দিষ্ট থাকে, তাহলে সমস্ত সংযোগকারী পরামিতি, এমনকি প্রয়োজন অনুসারে মনোনীত করা, ঐচ্ছিক হিসাবে গণ্য করা যেতে পারে, যদি না অন্যথায় বলা হয়।

উদাহরণ

একটি একক BigQuery ডেটা সোর্স ( ds0 ) দিয়ে একটি রিপোর্ট কনফিগার করে এবং ডেটা সোর্স কনফিগারেশনকে সম্পূর্ণরূপে প্রতিস্থাপন করে:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare

যখন রিপোর্টে একটি একক ডেটা উৎস থাকে তখন ডেটা উৎস উপনাম বাদ দেওয়া যেতে পারে। উপরের ইউআরএলটি নিম্নলিখিতগুলিতে সরলীকৃত করা যেতে পারে:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.datasourceName=MyNewDataSource
  &ds.connector=bigQuery
  &ds.type=TABLE
  &ds.projectId=bigquery-public-data
  &ds.datasetId=samples
  &ds.tableId=shakespeare

একটি একক BigQuery ডেটা সোর্স ( ds0 ) সহ একটি প্রতিবেদন কনফিগার করে এবং শুধুমাত্র ডেটা উৎসের বিলিং প্রকল্প আইডি আপডেট করে :

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.billingProjectId=my-billing-project

দুটি ডেটা উত্স সহ একটি প্রতিবেদন কনফিগার করে, একটি BigQuery ডেটা উত্স ( ds0 ) এবং একটি Google Analytics ডেটা উত্স ( ds1 )৷ BigQuery ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপিত হয়, যখন Google Analytics কনফিগারেশন একটি একক প্যারামিটার আপডেট করে এবং যেকোনো অনির্দিষ্ট সংযোগকারী প্যারামিটারের জন্য ds1 টেমপ্লেট ডেটা উৎসের উপর নির্ভর করে:

https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &r.reportName=MyNewReportWithMultipleDataSources
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds1.viewId=92320289

তৈরি করুন বনাম যোগ করুন

কখনও কখনও একাধিক রিপোর্টে একই ডেটা সোর্স থাকা উপযোগী হতে পারে তাই ডেটা সোর্সের আপডেটগুলি একসঙ্গে সমস্ত রিপোর্টকে প্রভাবিত করে৷ লিঙ্কিং API এর সাথে একটি প্রতিবেদন তৈরি করার সময়, আপনি নিম্নলিখিত সমস্ত শর্ত পূরণ হয়েছে তা নিশ্চিত করে আপনার টেমপ্লেট রিপোর্ট থেকে একটি ডেটাসোর্স পুনরায় যোগ করতে পারেন:

1. ডেটা উত্সটি পুনরায় ব্যবহারযোগ্য ( এম্বেড করা বনাম পুনঃব্যবহারযোগ্য ডেটা উত্স দেখুন)
2. url উপনাম দ্বারা ডেটা উৎস উল্লেখ করে না
3. url একটি ওয়াইল্ডকার্ড উপনাম ব্যবহার করে না ( ডেটা সোর্স ওরফে ওয়াইল্ডকার্ড দেখুন)

যখন লিঙ্কিং API-এর সাথে একটি নতুন ডেটা উত্স তৈরি করা হয়, তখন এটি ব্যবহারকারীর শংসাপত্রগুলি ব্যবহার করে যে url এ ক্লিক করেছে৷ এর অর্থ ব্যবহারকারীর অন্তর্নিহিত ডেটাতে অ্যাক্সেস থাকতে হবে বা সংযোগটি কাজ করবে না। নতুন উত্পন্ন প্রতিবেদনে ডেটা উত্সটি পুনরায় যুক্ত করার মাধ্যমে, আপনি এর প্রমাণপত্র সংরক্ষণ করতে পারেন যাতে ব্যবহারকারীরা তাদের নতুন প্রতিবেদনে ডেটা অ্যাক্সেস করা চালিয়ে যেতে পারেন।

ডাটা সোর্স ওরফে ওয়াইল্ডকার্ড

একাধিক ডেটা উত্সে লিঙ্কিং API প্যারামিটার প্রয়োগ করতে, ওয়াইল্ডকার্ড উপনাম ds.* ডেটা উত্স উপনামের জায়গায় ব্যবহার করা যেতে পারে।

এটি আপনার url থেকে পুনরাবৃত্তিমূলক পরামিতিগুলি সরানোর জন্য কার্যকর হতে পারে। উদাহরণস্বরূপ, যদি আপনার কাছে তিনটি BigQuery ডেটা উত্স সংযুক্ত একটি টেমপ্লেট থাকে এবং আপনি প্রতিটিতে projectId এবং datasetId প্রতিস্থাপন করতে চান তবে tableId সংরক্ষণ করতে চান, আপনি এটি এইভাবে লিখতে পারেন:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.ds1.projectId=client-project
  &ds.ds1.datasetId=client-dataset
  &ds.ds2.projectId=client-project
  &ds.ds2.datasetId=client-dataset
  &ds.ds3.projectId=client-project
  &ds.ds3.datasetId=client-dataset

অথবা, ds.* ওয়াইল্ডকার্ড সহ, আপনি এই সমতুল্য url ব্যবহার করতে পারেন:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset

লিঙ্কিং এপিআই-তে প্রদত্ত প্যারামিটারগুলি যেগুলি ds.* ওয়াইল্ডকার্ডগুলিকে প্রাধান্য দেওয়া হয়। উপরের উদাহরণে, আপনি ওয়াইল্ডকার্ড থেকে মানটিকে ওভাররাইড করতে একটি নির্দিষ্ট ডেটাসোর্স উপনাম যোগ করতে পারেন।

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset
  &ds.ds1.datasetId=client-dataset

আরও সাধারণভাবে, প্যারামিটার অগ্রাধিকারের ক্রম হল:

1. নির্দিষ্ট উপনাম সহ দেওয়া একটি প্যারামিটার ( ds.ds1.datasetId )
2. ওয়াইল্ডকার্ড ব্যবহার করে প্রদত্ত একটি প্যারামিটার ( ds.*.datasetId )
3. টেমপ্লেট ডেটাসোর্স থেকে প্রাপ্ত একটি মান, যদি ds.connector প্রদান না করা হয় ( প্রতিস্থাপন বনাম আপডেট দেখুন)
4. প্যারামিটারের জন্য ডিফল্ট মান, যদি এটি ঐচ্ছিক হয়।

সংযোগকারী রেফারেন্স

লিঙ্কিং API নিম্নলিখিত সংযোগকারী এবং কনফিগারেশন সমর্থন করে। প্রতিটি সংযোগকারীর জন্য, উপলভ্য ডেটা উৎস পরামিতির তালিকা প্রদান করা হয়।

BigQuery

BigQuery সংযোগকারী দুটি ধরণের প্রশ্ন সমর্থন করে, একটি TABLE ক্যোয়ারী, যেখানে আপনি ক্যোয়ারী করার জন্য টেবিলের সারণী আইডি এবং একটি CUSTOM_QUERY , যেখানে আপনি একটি টেবিলকে জিজ্ঞাসা করার জন্য একটি SQL বিবৃতি প্রদান করেন৷

টেবিল প্রশ্ন

নিম্নলিখিত পরামিতিগুলি প্রযোজ্য হয় যখন type TABLE সেট করা থাকে এবং আপনি প্রশ্ন করার জন্য টেবিলের আইডি প্রদান করেন।

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। BigQuery সংযোগকারীর জন্য bigQuery এ সেট করুন। সেট করা থাকলে, প্রদত্ত BigQuery কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .type	প্রয়োজনীয় ** প্রশ্নের ধরন। TABLE সেট করুন।
ds. alias .projectId	প্রয়োজনীয় ** প্রশ্ন করার জন্য টেবিলের প্রকল্প আইডি।
ds. alias .datasetId	প্রয়োজনীয় ** প্রশ্ন করার জন্য টেবিলের ডেটাসেট আইডি।
ds. alias .tableId	প্রয়োজনীয় ** প্রশ্ন করার জন্য টেবিলের টেবিল আইডি। তারিখ কাটা টেবিল : * (ওয়াইল্ডকার্ড অক্ষর) বা YYYYMMDD প্রত্যয়টি তারিখ শার্ডেড টেবিলের অনুসন্ধান করার সময় সমর্থিত। যদি একটি টেবিলকে Google Analytics, Firebase Analytics, বা Firebase Crashlytics হিসাবে চিহ্নিত করা হয়, তবে একটি নির্দিষ্ট করা না থাকলে একটি ডিফল্ট ক্ষেত্র টেমপ্লেট নির্বাচন করা হবে। ক্ষেত্র টেমপ্লেট টেবিল সম্পর্কিত পরামিতি দেখুন।
ds. alias .billingProjectId	ঐচ্ছিক। বিলিংয়ের জন্য ব্যবহার করার জন্য প্রকল্পের আইডি। সেট করা না থাকলে, projectId ব্যবহার করা হবে।
ds. alias .isPartitioned	ঐচ্ছিক। সারণীটি বিভাজিত হলে true হিসাবে সেট করুন এবং আপনি একটি তারিখ পরিসরের মাত্রা হিসাবে পার্টিশন কলাম ব্যবহার করতে চান। এটি শুধুমাত্র সময় ভিত্তিক পার্টিশনের ক্ষেত্রে প্রযোজ্য (যেমন একটি সময় ভিত্তিক পার্টিশনিং কলাম বা _PARTITIONTIME pseudocolumn ব্যবহার করে) এবং পূর্ণসংখ্যা পরিসর বিভাজিত টেবিলের জন্য কাজ করে না। অনির্দিষ্ট থাকলে ডিফল্ট false । আরও জানতে পার্টিশন করা টেবিলের ভূমিকা দেখুন।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে true ডিফল্ট। বিস্তারিত জানার জন্য refreshFields দেখুন।

Google Analytics, Firebase Analytics এবং Crashlytics-এর জন্য ফিল্ড টেমপ্লেট

গুগল অ্যানালিটিক্স, ফায়ারবেস অ্যানালিটিক্স বা ফায়ারবেস ক্র্যাশলিটিক্স হিসাবে চিহ্নিত টেবিলগুলির জন্য, ক্ষেত্র টেমপ্লেট সেট করার জন্য অতিরিক্ত প্যারামিটার উপলব্ধ। অনির্দিষ্ট থাকলে, একটি ডিফল্ট টেমপ্লেট নির্বাচন করা হবে।

নাম	বর্ণনা
ds. alias .gaTemplateLevel	ঐচ্ছিক। ব্যবহার করার জন্য Google Analytics ক্ষেত্র টেমপ্লেট। Google Analytics টেবিলের জন্য একটি BigQuery রপ্তানি জিজ্ঞাসা করা হলেই প্রযোজ্য। ALL মধ্যে একটি, SESSION , HITS । Google অ্যানালিটিক্স টেবিলের জন্য, অনির্দিষ্ট থাকলে ডিফল্ট ALL ।
ds. alias .firebaseTemplateLevel	ঐচ্ছিক। ফায়ারবেস অ্যানালিটিক্স ফিল্ড টেমপ্লেট ব্যবহার করার জন্য। Firebase অ্যানালিটিক্স টেবিলের জন্য একটি BigQuery রপ্তানি জিজ্ঞাসা করা হলেই প্রযোজ্য। শুধুমাত্র EVENTS এ সেট করা যাবে। ফায়ারবেস অ্যানালিটিক্স টেবিলের জন্য, অনির্দিষ্ট থাকলে EVENTS ডিফল্ট।
ds. alias .crashlyticsTemplateLevel	Firebase Crashlytics ফিল্ড টেমপ্লেট ব্যবহার করার জন্য। শুধুমাত্র DEFAULT সেট করা যেতে পারে। Firebase Crashlytics টেবিলের জন্য একটি BigQuery রপ্তানি জিজ্ঞাসা করা হলেই প্রযোজ্য। Firebase Crashlytics টেবিলের জন্য, অনির্দিষ্ট থাকলে DEFAULT ডিফল্ট।

কাস্টম প্রশ্ন

নিম্নলিখিত প্যারামিটারগুলি প্রযোজ্য হয় যখন type CUSTOM_QUERY এ সেট করা থাকে এবং আপনি একটি সারণী জিজ্ঞাসা করার জন্য একটি SQL বিবৃতি প্রদান করেন৷

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। BigQuery সংযোগকারীর জন্য bigQuery এ সেট করুন। সেট করা থাকলে, প্রদত্ত BigQuery কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .type	প্রয়োজনীয় ** প্রশ্নের ধরন। CUSTOM_QUERY এ সেট করুন।
ds. alias .sql	প্রয়োজনীয় ** SQL কোয়েরি চালানোর জন্য।
ds. alias .billingProjectId	ঐচ্ছিক। বিলিংয়ের জন্য ব্যবহার করার জন্য প্রকল্পের আইডি। সেট করা না থাকলে, projectId ব্যবহার করা হবে। যদি projectId সেট করা না থাকে তাহলে প্রশ্ন করা টেবিলের প্রজেক্ট ব্যবহার করা হবে।
ds. alias .sqlReplace	ঐচ্ছিক। SQL ক্যোয়ারীতে প্রযোজ্য প্যাটার্ন এবং প্রতিস্থাপন স্ট্রিংগুলির একটি কমা দ্বারা সীমাবদ্ধ তালিকা৷ স্ট্রিং প্রতিস্থাপন শুধুমাত্র একটি প্যাটার্ন মিল থাকলেই প্রয়োগ করা হয়। প্যাটার্ন এবং প্রতিস্থাপন স্ট্রিং জোড়া আলাদা করতে একটি কমা ব্যবহার করুন। উদাহরণস্বরূপ, stringPattern1,replacementString1, stringPattern2,replacementString2 ।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে true ডিফল্ট। বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

একটি TABLE টাইপ কনফিগারেশন যেখানে ক্যোয়ারী একটি টেবিল আইডি দিয়ে সংজ্ঞায়িত করা হয়:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds0.billingProjectId=myProject

ওয়াইল্ডকার্ড অক্ষর প্রত্যয় ব্যবহার করে একটি তারিখ সংকীর্ণ সারণী জিজ্ঞাসা করার জন্য একটি TABLE টাইপ কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_*
  

YYYYMMDD প্রত্যয় ব্যবহার করে একটি তারিখ সংকীর্ণ সারণী জিজ্ঞাসা করার জন্য একটি TABLE টাইপ কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_YYYYMMDD
  

SESSION ফিল্ড টেমপ্লেট ব্যবহার করে Google Analytics টেবিলের জন্য একটি BigQuery এক্সপোর্ট কোয়েরি করার জন্য একটি TABLE টাইপ কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=my-gabq-project
  &ds.ds0.datasetId=1234567
  &ds.ds0.tableId=ga_sessions_YYYYMMDD
  &ds.ds0.gaTemplateLevel=SESSION
  

একটি TABLE টাইপ কনফিগারেশন একটি ইনজেশন টাইম পার্টিশন করা টেবিলের জন্য ক্যোয়ারী করতে এবং পার্টিশনিং কলামটিকে তারিখ ব্যাপ্তির মাত্রা হিসাবে ব্যবহার করুন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=acme-co-logs
  &ds.ds0.datasetId=logs
  &ds.ds0.tableId=logs_table
  &ds.ds0.isPartitioned=true

একটি CUSTOM_QUERY টাইপ কনফিগারেশন যেখানে তারা কোয়েরি একটি SQL স্টেটমেন্ট দিয়ে সংজ্ঞায়িত করা হয়:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=CUSTOM_QUERY
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
  &ds.ds0.billingProjectId=myProject

একটি CUSTOM_QUERY টাইপ কনফিগারেশন যেখানে শুধুমাত্র SQL স্টেটমেন্ট আপডেট করা হয় এবং বাকি কনফিগারেশনের জন্য টেমপ্লেট ডেটা সোর্স ব্যবহার করা হয়:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60

একটি CUSTOM_QUERY টাইপ কনফিগারেশন যেখানে sqlReplace ব্যবহার করে টেমপ্লেট ডেটা উৎসের SQL স্টেটমেন্ট আপডেট করা হয়:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset

# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
#   SELECT word, word_count FROM big-query-public-data.samples.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
#   SELECT word, word_count FROM new-project.new-dataset.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM new-project.new-dataset.raleigh

ক্লাউড স্প্যানার

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। ক্লাউড স্প্যানার সংযোগকারীর জন্য cloudSpanner সেট করুন। সেট করা থাকলে, প্রদত্ত ক্লাউড স্প্যানার কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .projectId	প্রয়োজনীয় ** প্রকল্প আইডি।
ds. alias .instanceId	প্রয়োজনীয় ** উদাহরণ আইডি।
ds. alias .databaseId	প্রয়োজনীয় ** ডেটাবেস আইডি।
ds. alias .sql	প্রয়োজনীয় ** SQL কোয়েরি চালানোর জন্য।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে true ডিফল্ট। বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

একটি SQL স্টেটমেন্ট সহ একটি ক্লাউড স্প্যানার কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=456def
  &ds.ds1.connector=cloudSpanner
  &ds.ds1.projectId=myProject
  &ds.ds1.instanceId=production
  &ds.ds1.datasetId=transactions
  &ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B

সম্প্রদায় সংযোগকারী

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। একটি সম্প্রদায় সংযোগকারীর জন্য community সেট করুন৷ সেট করা থাকলে, প্রদত্ত কমিউনিটি সংযোগকারী কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .connectorId	প্রয়োজনীয় ** সম্প্রদায় সংযোগকারী connectorId (একটি deploymentId নামেও পরিচিত)।
ds. alias .parameters	ঐচ্ছিক। সম্প্রদায় সংযোগকারীর সংযোগকারী কনফিগারেশন দ্বারা সংজ্ঞায়িত অতিরিক্ত সংযোগকারী-নির্দিষ্ট পরামিতি।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে true ডিফল্ট। বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

state এবং city কনফিগারেশন পরামিতি সহ একটি সম্প্রদায় সংযোগকারীর সাথে সংযোগ করুন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=community
  &ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
  &ds.ds5.state=CA
  &ds.ds5.city=Sacramento

দ্রষ্টব্য: একটি স্টেপড কনফিগারেশন ব্যবহার করে এমন সংযোগকারীগুলির জন্য বিশেষ হ্যান্ডলিং প্রয়োজন হয় না ।

গুগল বিশ্লেষক

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। Google Analytics সংযোগকারীর জন্য googleAnalytics এ সেট করুন। সেট করা থাকলে, প্রদত্ত Google Analytics কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .accountId	প্রয়োজনীয় ** অ্যাকাউন্ট আইডি।
ds. alias .propertyId	প্রয়োজনীয় ** সম্পত্তি আইডি।
ds. alias .viewId	ভিউ আইডি। ইউনিভার্সাল অ্যানালিটিক্স বৈশিষ্ট্যের জন্য প্রয়োজনীয় ** । Google Analytics 4 বৈশিষ্ট্যের জন্য সেট করবেন না।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে ডিফল্ট false । বিস্তারিত জানার জন্য refreshFields দেখুন।

দ্রষ্টব্য: ইউনিভার্সাল অ্যানালিটিক্স (UA) এবং Google Analytics 4 (GA4) কনফিগারেশনগুলি সামঞ্জস্যপূর্ণ নয় কারণ তাদের বিভিন্ন মাত্রা এবং মেট্রিক্স রয়েছে৷ GA4 প্রপার্টির জন্য তৈরি করা ডেটা সোর্সের জন্য UA কনফিগারেশন সেট করা কাজ করবে না এবং এর বিপরীতে। ds.refreshFields প্যারামিটারটিকে true হিসাবে সেট করার কথা বিবেচনা করুন যদি আপনি চান যে আপনার প্রতিবেদনের টেমপ্লেটটি যেকোন একটি সম্পত্তির সাথে কাজ করতে পারে৷

উদাহরণ

একটি ইউনিভার্সাল অ্যানালিটিক্স সম্পত্তির জন্য একটি Google Analytics কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=UA-54516992-1
  &ds.ds2.viewId=92320289

একটি Google Analytics 4 সম্পত্তির জন্য একটি Google Analytics কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=213025502

গুগল ক্লাউড স্টোরেজ

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। googleCloudStorage Google ক্লাউড স্টোরেজ সংযোগকারীতে সেট করুন। সেট করা থাকলে, প্রদত্ত Google ক্লাউড স্টোরেজ কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .pathType	প্রয়োজনীয় ** পথের ধরন। একটি একক ফাইল নির্বাচন করতে FILE বা প্রদত্ত পথের জন্য সমস্ত ফাইল নির্বাচন করতে FOLDER ব্যবহার করুন।
ds. alias .path	প্রয়োজনীয় ** ফাইল পাথ (যেমন MyBucket/MyData/MyFile.csv ) যদি pathType FILE হয় অথবা ফোল্ডার পাথ (যেমন *MyBucket/MyData ) যদি pathType FOLDER হয়।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে true ডিফল্ট। বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

একটি একক ফাইলের জন্য একটি Google ক্লাউড স্টোরেজ কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FILE
  &ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv

পথের সমস্ত ফাইলের জন্য একটি Google ক্লাউড স্টোরেজ কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FOLDER
  &ds.ds50.path=MyBucket%2FMyData

Google পত্রক

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। Google পত্রক সংযোগকারীর জন্য googleSheets এ সেট করুন। সেট করা থাকলে, প্রদত্ত Google পত্রক কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .spreadsheetId	প্রয়োজনীয় ** স্প্রেডশীট আইডি।
ds. alias .worksheetId	প্রয়োজনীয় ** ওয়ার্কশীট আইডি।
ds. alias .hasHeader	ঐচ্ছিক। হেডার হিসাবে প্রথম সারি ব্যবহার করার জন্য true সেট করুন। অনির্দিষ্ট থাকলে true ডিফল্ট। কলাম শিরোনাম অনন্য হতে হবে. খালি শিরোনাম সহ কলাম ডেটা উৎসে যোগ করা হবে না।
ds. alias .includeHiddenCells	ঐচ্ছিক। লুকানো কক্ষ অন্তর্ভুক্ত করতে true সেট করুন। অনির্দিষ্ট থাকলে true ডিফল্ট।
ds. alias .includeFilteredCell	ঐচ্ছিক। ফিল্টার করা কক্ষগুলি অন্তর্ভুক্ত করতে true সেট করুন৷ অনির্দিষ্ট থাকলে true ডিফল্ট।
ds. alias .range	ঐচ্ছিক। ব্যাপ্তি, যেমন A1:B52।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে true ডিফল্ট। বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

একটি Google পত্রক কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437

শিরোনাম হিসাবে ব্যবহৃত প্রথম সারি সহ একটি Google পত্রক কনফিগারেশন এবং লুকানো এবং ফিল্টার করা ঘর অন্তর্ভুক্ত:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.hasHeader=true
  &ds.ds3.includeHiddenCells=true
  &ds.ds3.includeFilteredCells=true

একটি পরিসর সহ একটি Google পত্রক কনফিগারেশন (A1:D20):

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.range=A1%3AD20

লুকার

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। লুকার সংযোগকারীর জন্য looker সেট করুন। সেট করা থাকলে, প্রদত্ত লুকার কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .instanceUrl	প্রয়োজনীয় ** লুকার ইনস্ট্যান্স URL।
ds. alias .model	প্রয়োজনীয় ** লুকার মডেল।
ds. alias .explore	প্রয়োজনীয় ** The Looker Explore.
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে ডিফল্ট false । বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

একটি লুকার এক্সপ্লোরের সাথে সংযোগ করুন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=looker
  &ds.ds5.instanceUrl=my.looker.com
  &ds.ds5.model=thelook
  &ds.ds5.explore=orders

সার্চ কনসোল

পরামিতি নাম	বর্ণনা
ds. alias .connector	ঐচ্ছিক। সার্চ কনসোল সংযোগকারীর জন্য searchConsole সেট করুন। সেট করা থাকলে, প্রদত্ত সার্চ কনসোল কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .siteUrl	প্রয়োজনীয় ** সাইটের URL। একটি ডোমেন সম্পত্তির জন্য, sc-domain\:
ds. alias .tableType	প্রয়োজনীয় ** টেবিলের ধরন সেট করে। SITE_IMPRESSION বা URL_IMPRESSION এর একটি হতে পারে৷
ds. alias .searchType	প্রয়োজনীয় ** অনুসন্ধানের ধরন সেট করে। WEB , IMAGE , VIDEO বা NEWS এর একটি হতে পারে।
ds. alias .refreshFields	ঐচ্ছিক। অনির্দিষ্ট থাকলে ডিফল্ট false । বিস্তারিত জানার জন্য refreshFields দেখুন।

উদাহরণ

একটি URL-প্রিফিক্স সম্পত্তির জন্য একটি অনুসন্ধান কনসোল কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

একটি ডোমেন সম্পত্তির জন্য একটি অনুসন্ধান কনসোল কনফিগারেশন:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=sc-domain%3Aexample.com
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

টেমপ্লেট অনুমতি

ব্যবহারকারীদের জন্য সর্বোত্তম ব্যবহারকারীর অভিজ্ঞতা নিশ্চিত করতে, আপনার টেমপ্লেট রিপোর্ট এবং সংশ্লিষ্ট ডেটা উত্সগুলির জন্য রিপোর্ট অ্যাক্সেসের অনুমতিগুলি সঠিকভাবে সেট করা গুরুত্বপূর্ণ৷ প্রয়োজনীয় অনুমতিগুলি রিপোর্ট টেমপ্লেট এমবেডেড বনাম পুনঃব্যবহারযোগ্য ডেটা উত্স ব্যবহার করে কিনা এবং লিঙ্কিং API কনফিগারেশন একটি ডেটা উত্স কনফিগারেশন প্রতিস্থাপন বা আপডেট করার জন্য সেট করা হয়েছে কিনা তার উপর নির্ভর করে৷

নিম্নলিখিত সারণীটি টেমপ্লেট ডেটা উত্স এবং লিঙ্কিং API কনফিগারেশনের উপর ভিত্তি করে সর্বোত্তম ব্যবহারকারীর অভিজ্ঞতার জন্য প্রস্তাবিত ডেটা উত্স অ্যাক্সেস সরবরাহ করে:

ডেটা উৎসের ধরন	ডেটা উৎসের জন্য API কনফিগারেশন লিঙ্ক করা	তথ্য উৎস অনুমতি জন্য সুপারিশ	মন্তব্য
এমবেডেড	প্রতিস্থাপন করুন	N/A - দেখার অ্যাক্সেস রিপোর্ট থেকে উত্তরাধিকারসূত্রে পাওয়া যাবে।	ব্যবহারকারীর যদি টেমপ্লেট রিপোর্ট দেখার অ্যাক্সেস থাকে, তাহলে তারা স্বয়ংক্রিয়ভাবে যেকোনো এমবেডেড ডেটা উৎসে দেখার অ্যাক্সেস পাবে।
এমবেডেড	হালনাগাদ	N/A - দেখার অ্যাক্সেস রিপোর্ট থেকে উত্তরাধিকারসূত্রে পাওয়া যাবে।	ব্যবহারকারীর যদি টেমপ্লেট রিপোর্ট দেখার অ্যাক্সেস থাকে, তাহলে তারা স্বয়ংক্রিয়ভাবে যেকোনো এমবেডেড ডেটা উৎসে দেখার অ্যাক্সেস পাবে।
পুনর্ব্যবহারযোগ্য	প্রতিস্থাপন করুন	ব্যবহারকারীর ভিউ অ্যাক্সেসের প্রয়োজন নেই।	যেহেতু ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে লিঙ্কিং API এর মাধ্যমে প্রতিস্থাপিত হচ্ছে, তাই ভিউ অ্যাক্সেসের প্রয়োজন নেই।
পুনর্ব্যবহারযোগ্য	হালনাগাদ	ব্যবহারকারীর ভিউ এক্সেস প্রয়োজন.	টেমপ্লেট ডেটা উৎস থেকে কনফিগারেশন পড়তে এবং ব্যবহার করতে সক্ষম হওয়ার জন্য লিঙ্কিং API-এর জন্য ডেটা উৎসে ভিউ অ্যাক্সেস প্রয়োজন। ব্যবহারকারীদের দেখার অ্যাক্সেস না থাকলে রিপোর্ট লোড করার সময় তারা একটি ত্রুটি পাবে।

একটি ফাঁকা বা ডিফল্ট রিপোর্ট ব্যবহার করুন

একটি ফাঁকা প্রতিবেদন বা ডিফল্ট প্রতিবেদন ব্যবহার করতে, আপনার লিঙ্কিং APIকে নিম্নরূপ কনফিগার করুন:

প্রতিবেদনের প্রকার	reportId নিয়ন্ত্রণ পরামিতি সেট করুন	ডেটা সোর্স ( ds ) প্যারামিটার সেট করুন।	মন্তব্য
খালি রিপোর্ট	না	না
ডিফল্ট রিপোর্ট	না	হ্যাঁ	ডিফল্ট রিপোর্ট লুকার স্টুডিও দ্বারা প্রদান করা হয়. ডিফল্ট রিপোর্টের জন্য ডাটা সোর্স প্যারামিটার নির্দিষ্ট করার সময় ডেটা সোর্স উপনাম ব্যবহার করার প্রয়োজন নেই, যেহেতু ডিফল্ট রিপোর্টে একটি একক এমবেডেড ডেটা সোর্স রয়েছে।

মূল পয়েন্ট: একটি ফাঁকা বা ডিফল্ট রিপোর্ট ব্যবহার করার সময় reportId ব্যতীত নিয়ন্ত্রণ পরামিতি এবং রিপোর্ট প্যারামিটার সেট করা যেতে পারে।

নিম্নলিখিত উদাহরণগুলি বিভিন্ন লিঙ্কিং API URL গুলি দেখায় যা একটি ফাঁকা বা ডিফল্ট রিপোর্ট ব্যবহার করে৷

একটি ফাঁকা প্রতিবেদন দিয়ে প্রতিবেদন তৈরির কর্মপ্রবাহ শুরু করুন:

https://lookerstudio.google.com/reporting/create

একটি ফাঁকা প্রতিবেদন দিয়ে প্রতিবেদন তৈরির কার্যপ্রবাহ শুরু করুন এবং প্রতিবেদনের নাম সেট করুন:

https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport

একটি Google পত্রক সংযোগকারী কনফিগারেশনের সাথে ডিফল্ট রিপোর্ট টেমপ্লেট ব্যবহার করুন:

https://lookerstudio.google.com/reporting/create?
  ds.connector=googleSheets
  &ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
  &ds.worksheetId=0

একটি প্রতিবেদন এম্বেড করুন

লিঙ্কিং এপিআই দিয়ে তৈরি একটি প্রতিবেদন এম্বেড করতে, ইউআরএল প্যারামিটার সেট করুন এবং /embed/ পাথ অন্তর্ভুক্ত করুন। একটি লিঙ্কিং API এম্বেড URL অবশ্যই নিম্নলিখিত ফর্মের হতে হবে:

https://lookerstudio.google.com/embed/reporting/create?parameters

আইডি এবং উপনাম খুঁজুন

রিপোর্ট আইডি

রিপোর্ট আইডি খুঁজে পেতে:

1. আপনি একটি টেমপ্লেট হিসাবে ব্যবহার করতে চান রিপোর্ট খুলুন. রিপোর্টের URL পরিদর্শন করুন. reporting/ এবং /page মধ্যে অংশ হল রিপোর্ট আইডি। উদাহরণস্বরূপ, নিম্নলিখিত URL-এ, 0B_U5RNpwhcE6SF85TENURnc4UjA হল রিপোর্ট আইডি:

https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M

রিপোর্টের ইউআরএলে রিপোর্ট আইডি খুঁজুন।

ডাটা সোর্স ওরফে

একটি প্রতিবেদনে একাধিক ডেটা উৎস থাকতে পারে। একটি ডেটা উৎসকে তার উপনাম দ্বারা উল্লেখ করা উচিত।

একটি ডেটা উৎস উপনাম খুঁজে পেতে:

1. প্রতিবেদনটি সম্পাদনা করুন।
2. টুলবার থেকে, রিসোর্স > যোগ করা ডেটা সোর্স ম্যানেজ করুন নির্বাচন করুন।
3. প্রতিটি ডেটা উৎসের জন্য উপনাম তথ্য খুঁজতে উপনাম কলাম পরীক্ষা করুন।

একটি ডেটা উৎস যোগ বা সরানো হলে পিছনের সামঞ্জস্য নিশ্চিত করতে আপনি উপনামের নাম সম্পাদনা করতে পারেন।

ডেটা সোর্স ম্যানেজমেন্ট পৃষ্ঠায় ডেটা সোর্স উপনাম খুঁজুন।

সংযোগকারী প্রকার

একটি প্রতিবেদনে একাধিক ডেটা উত্স থাকতে পারে, প্রতিটি একটি সংযোগকারী কনফিগার করে তৈরি করা হয়েছে৷ একটি ডেটা উৎস তৈরি করতে ব্যবহৃত সংযোগকারী প্রকার খুঁজে পেতে:

1. প্রতিবেদনটি সম্পাদনা করুন।
2. টুলবার থেকে, রিসোর্স > যোগ করা ডেটা সোর্স ম্যানেজ করুন নির্বাচন করুন।
3. একটি ডেটা উৎস তৈরি করতে ব্যবহৃত সংযোগকারী সনাক্ত করতে সংযোগকারী প্রকার কলাম পরীক্ষা করুন।

ডেটা সোর্স ম্যানেজমেন্ট পেজে ডেটা সোর্স কানেক্টরের ধরন খুঁজুন।

টিপস এবং সমস্যা সমাধান

আপনার সমস্যা হলে, সম্ভাব্য সমস্যা এবং সাধারণ ভুল কনফিগারেশন শনাক্ত করতে নিচের বিবরণ পর্যালোচনা করুন।

ডিবাগ ডায়ালগ

লুকার স্টুডিও দ্বারা ব্যাখ্যা করা লিঙ্কিং API কনফিগারেশন পর্যালোচনা করতে ডিবাগ ডায়ালগ ব্যবহার করুন। এটি API এর সাথে সমস্যাগুলি ডিবাগ করতে সহায়তা করতে পারে।

• লিঙ্কিং এপিআই ইউআরএল পার্স করার সময় একটি ত্রুটির সম্মুখীন হলে, ত্রুটি সম্পর্কে বিশদ বিবরণ সহ একটি ডায়ালগ স্বয়ংক্রিয়ভাবে প্রদর্শিত হবে।
• যখন একটি ত্রুটি ঘটে এবং কোন ডায়ালগ স্বয়ংক্রিয়ভাবে প্রদর্শিত হয় না, প্রতিবেদনের উপরের ডানদিকে তথ্য বোতামটি সন্ধান করুন৷ অতিরিক্ত ডিবাগ তথ্যের জন্য ক্লিক করুন.

  

• যদি কোনো তথ্য বোতাম উপলব্ধ না হয়, আপনি যেকোনো লিঙ্কিং API URL-এর শেষে &c.explain=true প্যারামিটার যোগ করে বোতামটি সক্রিয় করতে পারেন।

অনুমতি

নিশ্চিত করুন যে আপনার কাছে ডেটা উৎসের ধরন এবং লিঙ্কিং API কনফিগারেশনের জন্য সঠিক টেমপ্লেট অনুমতি সেট করা আছে। বিস্তারিত জানার জন্য টেমপ্লেট অনুমতি দেখুন।

আপডেট বনাম প্রতিস্থাপন

একটি ডেটা সোর্স টেমপ্লেট থেকে ডেটা সোর্স কনফিগারেশন আপডেট করা হলে, টেমপ্লেট ডেটা সোর্স কনফিগারেশন এবং লিঙ্কিং API কনফিগারেশন পর্যালোচনা করে নিশ্চিত করুন যে সেগুলি সামঞ্জস্যপূর্ণ। নিশ্চিত করুন যে নতুন কনফিগারেশন থেকে প্রাপ্ত ক্ষেত্রগুলি রিপোর্ট উপাদান এবং কনফিগারেশনের সাথে সামঞ্জস্যপূর্ণ।

একটি আপডেট বনাম প্রতিস্থাপন সম্পাদন করার সময় অনির্ধারিত আচরণের সাথে একটি অবৈধ কনফিগারেশন সেট করা সম্ভব। বিস্তারিত জানার জন্য প্রতিস্থাপন বনাম আপডেট দেখুন।

রিফ্রেশ ক্ষেত্র

আপনি যদি একটি টেমপ্লেট ডেটা উত্সের জন্য ক্ষেত্রের নাম, প্রকার বা সমষ্টি কনফিগার করে থাকেন, তাহলে এই পরিবর্তনগুলি শুধুমাত্র একটি লিঙ্কিং API কনফিগার করা ডেটা উত্সে বহন করবে যদি ds.refreshFields প্যারামিটারটি false সেট করা থাকে।

আপনার লিঙ্কিং API URL এর ds.refreshFields ডেটা সোর্স প্যারামিটার পর্যালোচনা করুন৷ যদি বাদ দেওয়া হয়, তাহলে নিশ্চিত করুন যে প্রতিটি সংযোগকারী প্রকারের প্যারামিটারের ডিফল্ট মান আপনার ব্যবহারের ক্ষেত্রে সঠিক।

Generally, if you have configured fields in the template data source and are certain that new data source configurations via the Linking API will always yield the exact same fields, then setting refreshFields to false is recommended.

For example, if during the creation of a report template, Looker Studio identifies a particular data source field as type Number and you change it to type Year , this field configuration change is now part of the template data source. Any chart in the report template that uses the corrected field will expect a Year and if the chart is time-based it may not render otherwise. If the Linking API is used to provide a new data source configuration that yields the exact same fields, there are two outcomes based on the value of the refreshFields parameter:

• If set to true , the field configuration from the template data source will not carry-over, and charts may potentially fail to load if they depend on the same field configuration (ie a field of type Year is expected).

• If set to false , the field configuration from the template data source will carry-over to the new data source and report charts will receive the same fields with the same configuration and load successfully.

Key Point: Calculated fields and Parameters defined in template data sources will always carry-over to newly created data sources and are not affected by the value of refreshFields .

Feedback and support

Use the Issue Tracker to report Linking API issues or to provide feedback. See Support for general resources on getting help and asking questions.

Changelog

2023-06-06

• Added r.measurementId and r.keepMeasurementId report parameters to configure the Google Analytics Measurement IDs report setting.
• Added ds.keepDatasourceName to control reuse of the template data source name.
• Added an Embed report section.
• BigQuery connector
  • Added sqlReplace . Lets you specify pattern and replacement strings to update the SQL query of the template data source.

2023-05-22

• Added support for the Looker connector.
• Added support for Community Connectors .

2022-11-21

• Added the capability to use a blank report. See Use a blank or default report
• Added a refreshFields section to Tips & troubleshooting .

2022-11-14

• The Surveys connector reference has been removed due to the Google Surveys Sunset .

2022-06-15

• Out of beta
  • The Integration API has been renamed to Linking API .
  • Linking API is out of beta.
• Added the pageId control parameter to allow linking to a specific report page.
• Added the mode control parameter to set the report state to View or Edit mode on load.
• Data sources configurations can now be replaced entirely or partially updated. This behavior is determined by whether the ds.connector parameter is set. See Replace vs update for details.
• A default template is now used if a report template is not provide using the c.reportId parameter.
• Added the ds.refreshFields data source parameter. This allows you to control whether data source fields are refreshed when loading a data source configuration.
• BigQuery connector
  • projectId is not required when type is set to CUSTOM_QUERY .
  • When billingProjectId is not set then the billing project will fallback to projectId or the project of the queried table.
  • Added support for date partitioned tables. Set the isPartitioned parameter to true to use the partition field as a date range dimension.
  • Added support for querying date partitioned tables using the wildcard character or YYYYMMDD table suffix.
  • Added support for querying Google Analytics, Firebase Analytics, or Crashlytics tables and selecting a fields template.
• Google Sheets
  • hasHeader defaults to true , consistent with the web UI default.
  • includeHiddenAndFilteredCell split into includeHiddenCells and
  • includeFilteredCells . Both now default to true , consistent with the web UI default.
• Search Console connector
  • Renamed the propertyType parameter to searchType .
• Surveys connector
  • surveyId now accepts a single survey ID or a comma-separated list of survey IDs.

2021-12-16

• Initial release of the Integration API.
  • Supports linking to an existing report and setting the report name.
  • Multiple data sources can be configured and each data source name can be set.
  • Support for the following connector types: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Sheets, Google Surveys, Search Console.