API লিঙ্ক করা

ভূমিকা

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

এই ডকুমেন্টটি লিঙ্কিং এপিআই ইউআরএলগুলির প্রয়োজনীয় ফর্ম্যাট এবং উপলব্ধ প্যারামিটারগুলি বর্ণনা করে।

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

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

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

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

ডেভেলপার এবং ব্যবহারকারীরা লিঙ্কিং API-এর সাথে কীভাবে ইন্টারঅ্যাক্ট করে তা নিম্নলিখিত বর্ণনা করা হয়েছে।

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

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

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

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

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

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

আবশ্যকতা

একটি লিঙ্কিং এপিআই ইউআরএল প্রত্যাশা অনুযায়ী কাজ করছে কিনা তা নিশ্চিত করার জন্য, নিম্নলিখিতগুলি প্রয়োজন:

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

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

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

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

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

URL টি একটি ওয়েব ব্রাউজারের প্রেক্ষাপটে ব্যবহার করা হবে বলে আশা করা হচ্ছে, সাধারণত একজন ব্যবহারকারী একটি লিঙ্কে ক্লিক করলে বা 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 এনকোডিং দেখুন।

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

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

Linking API URL এর মাধ্যমে দেখা হলে নিয়ন্ত্রণ পরামিতিগুলি রিপোর্টের অবস্থা নির্ধারণ করে।

প্যারামিটারের নাম	বিবরণ
c.reportId	ঐচ্ছিক। টেমপ্লেট রিপোর্ট আইডি। লুকার স্টুডিও নির্দিষ্ট রিপোর্টটি খুলবে এবং কনফিগার করবে। আইডিটি কীভাবে খুঁজে পাবেন তার বিস্তারিত জানার জন্য, রিপোর্ট আইডি দেখুন। যদি নির্দিষ্ট না করা থাকে, তাহলে একটি ফাঁকা রিপোর্ট বা ডিফল্ট রিপোর্ট টেমপ্লেট ব্যবহার করা হয়, বিস্তারিত জানার জন্য একটি ফাঁকা বা ডিফল্ট রিপোর্ট ব্যবহার করুন দেখুন।
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 Measurement ID রিপোর্টের সেটিং ডিফল্টভাবে আনসেট হয়ে যায়। যদি r.measurementId এবং r.keepMeasurementId সেট করা থাকে, তাহলে ID সেট করার জন্য r.keepMeasurementId অগ্রাধিকার পায়।
r.keepMeasurementId	ঐচ্ছিক। টেমপ্লেট রিপোর্ট ব্যবহার করার জন্য Google Analytics পরিমাপ আইডি true হিসেবে সেট করুন। নির্দিষ্ট না থাকলে ডিফল্টভাবে false হিসেবে সেট করা হবে। যদি r.measurementId এবং r.keepMeasurementId নির্দিষ্ট না থাকে, তাহলে Google Analytics Measurement ID রিপোর্টের সেটিং ডিফল্টভাবে আনসেট হয়ে যায়। যদি r.measurementId এবং r.keepMeasurementId সেট করা থাকে, তাহলে ID সেট করার জন্য 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 কীভাবে খুঁজে পাবেন সে সম্পর্কে বিস্তারিত জানার জন্য, ডেটা সোর্স উপনাম দেখুন।

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

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

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

নাম	বিবরণ
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-এ নির্দিষ্ট করা যেতে পারে। লিঙ্কিং API URL-এ প্রদত্ত নয় এমন যেকোনো প্যারামিটার নির্দিষ্ট করতে টেমপ্লেট ডেটা সোর্স কনফিগারেশন ব্যবহার করা হবে। টেমপ্লেট ডেটা সোর্সের সংযোগকারীর ধরণ কীভাবে সনাক্ত করবেন সে সম্পর্কে বিস্তারিত জানার জন্য, সংযোগকারীর ধরণ দেখুন। ds.connector প্যারামিটার কীভাবে টেমপ্লেট ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপন করা হবে নাকি অনির্দিষ্ট প্যারামিটার আপডেট করতে ব্যবহার করা হবে তা প্রভাবিত করে সে সম্পর্কে আরও জানতে, Replace বনাম update দেখুন।
ds. alias .refreshFields	ঐচ্ছিক। Linking API এর মাধ্যমে নির্দিষ্ট করা ডেটা সোর্স কনফিগারেশন ব্যবহার করে ডেটা সোর্স ফিল্ড রিফ্রেশ করতে এবং নতুন ফিল্ড নির্বাচনের মাধ্যমে রিপোর্ট কম্পোনেন্ট আপডেট করতে true তে সেট করুন। true সাধারণত সংযোগকারীর ধরণ পরিবর্তন করার সময় অথবা সংযোগকারীর ধরণগুলির জন্য নির্দিষ্ট করা হয় যেখানে কনফিগারেশন পরিবর্তন বিভিন্ন ক্ষেত্র তৈরি করে (যেমন BigQuery ডেটা সোর্সের ক্ষেত্রগুলি প্রায়শই বিভিন্ন টেবিল কনফিগারেশনের সাথে পরিবর্তিত হয়)। টেমপ্লেট রিপোর্ট থেকে ডেটা সোর্স ফিল্ডগুলিকে অপরিবর্তিত রাখতে false তে সেট করুন। false সাধারণত তখনই নির্দিষ্ট করা হয় যখন নতুন ডেটা কনফিগারেশন ঠিক একই ফিল্ড দেয় এবং আপনি টেমপ্লেট ডেটা সোর্সে করা যেকোনো ফিল্ড পরিবর্তন বজায় রাখতে পছন্দ করবেন। যদি নির্দিষ্ট না করা থাকে, তাহলে সংযোগকারীর ধরণ অনুসারে ডিফল্টগুলি পরিবর্তিত হয়। যদি আপনি ডিফল্ট আচরণটি ওভাররাইড করতে চান তবে সংযোগকারী নির্দিষ্ট ডিফল্টগুলির জন্য সংযোগকারীর রেফারেন্সটি পর্যালোচনা করুন। refreshFields ব্যবহার করার সময় বিবেচ্য বিষয়গুলি: যদি refreshFields false তে সেট করা থাকে এবং Linking API এর মাধ্যমে নির্দিষ্ট করা ডেটা সোর্স কনফিগারেশন টেমপ্লেট রিপোর্টে ব্যবহৃত ফিল্ড থেকে ভিন্ন ফিল্ড দেয়, তাহলে ব্যবহারকারী সম্ভবত প্রভাবিত উপাদানগুলির জন্য একটি কনফিগারেশন ত্রুটি দেখতে পাবেন। টেমপ্লেট ডেটা সোর্সের ফিল্ডগুলিতে (যেমন নাম, ধরণ, সমষ্টি, ইত্যাদি) পরিবর্তনগুলি নতুন ডেটা সোর্সে স্থানান্তরিত হয় না যখন 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

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

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

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

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

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

যখন Linking 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

লিঙ্কিং API-তে প্রদত্ত প্যারামিটারগুলি যা ds.* ওয়াইল্ডকার্ড ব্যবহার করে না, সেগুলিকে 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 সংযোগকারী দুই ধরণের কোয়েরি সমর্থন করে, একটি TABLE কোয়েরি, যেখানে আপনি কোয়েরি করার জন্য টেবিলের টেবিল আইডি প্রদান করেন এবং একটি CUSTOM_QUERY , যেখানে আপনি একটি টেবিল কোয়েরি করার জন্য একটি SQL স্টেটমেন্ট প্রদান করেন।

টেবিল কোয়েরি

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

প্যারামিটারের নাম	বিবরণ
ds. alias .connector	ঐচ্ছিক। BigQuery সংযোগকারীর জন্য bigQuery তে সেট করুন। যদি সেট করা থাকে, তাহলে প্রদত্ত BigQuery কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। Replace বনাম update দেখুন।
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 সিউডোকলাম ব্যবহার করা) এবং পূর্ণসংখ্যা রেঞ্জ পার্টিশন করা টেবিলের জন্য কাজ করে না। নির্দিষ্ট না থাকলে ডিফল্ট হিসেবে false থাকে। আরও জানতে পার্টিশন করা টেবিলের ভূমিকা দেখুন।
ds. alias .refreshFields	ঐচ্ছিক। নির্দিষ্ট না থাকলে ডিফল্টভাবে true হবে। বিস্তারিত জানার জন্য refreshFields দেখুন।

গুগল অ্যানালিটিক্স, ফায়ারবেস অ্যানালিটিক্স এবং ক্র্যাশলিটিক্সের জন্য ফিল্ডস টেমপ্লেট

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

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

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

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

প্যারামিটারের নাম	বিবরণ
ds. alias .connector	ঐচ্ছিক। BigQuery সংযোগকারীর জন্য bigQuery তে সেট করুন। যদি সেট করা থাকে, তাহলে প্রদত্ত BigQuery কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। Replace বনাম update দেখুন।
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 টাইপ কনফিগারেশন যেখানে কোয়েরিটি একটি Table ID দিয়ে সংজ্ঞায়িত করা হয়:

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 Export কোয়েরি করার জন্য একটি 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 টাইপ কনফিগারেশন যেখানে টেমপ্লেট ডেটা সোর্সের SQL স্টেটমেন্ট sqlReplace ব্যবহার করে আপডেট করা হয়:

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 সেট করুন। যদি সেট করা থাকে, তাহলে প্রদত্ত কমিউনিটি কানেক্টর কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। Replace বনাম update দেখুন।
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 কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। Replace বনাম update দেখুন।
ds. alias .accountId	** অ্যাকাউন্ট আইডি প্রয়োজন ।
ds. alias .propertyId	** প্রপার্টি আইডি প্রয়োজন ।
ds. alias .viewId	ভিউ আইডি। ইউনিভার্সাল অ্যানালিটিক্স বৈশিষ্ট্যের জন্য ** প্রয়োজনীয় । Google Analytics 4 প্রপার্টিগুলির জন্য সেট করবেন না।
ds. alias .refreshFields	ঐচ্ছিক। নির্দিষ্ট না থাকলে ডিফল্টভাবে false । বিস্তারিত জানার জন্য রিফ্রেশফিল্ড দেখুন।

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

উদাহরণ

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

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 Cloud Storage সংযোগকারী । যদি সেট করা থাকে, তাহলে প্রদত্ত Google ক্লাউড স্টোরেজ কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। প্রতিস্থাপন বনাম আপডেট দেখুন।
ds. alias .pathType	** পাথের ধরণ। একটি ফাইল নির্বাচন করতে FILE ব্যবহার করুন অথবা প্রদত্ত পাথের জন্য সমস্ত ফাইল নির্বাচন করতে FOLDER ব্যবহার করুন।
ds. alias .path	** যদি pathType FILE হয় তাহলে ফাইল পাথ (যেমন MyBucket/MyData/MyFile.csv ) অথবা যদি pathType FOLDER হয় তাহলে ফোল্ডার পাথ (যেমন *MyBucket/MyData )।
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

গুগল শিটস

প্যারামিটারের নাম	বিবরণ
ds. alias .connector	ঐচ্ছিক। Google Sheets সংযোগকারীর জন্য googleSheets এ সেট করুন। যদি সেট করা থাকে, তাহলে প্রদত্ত Google Sheets কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। Replace বনাম update দেখুন।
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 দেখুন।

উদাহরণ

একটি গুগল শিট কনফিগারেশন:

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

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

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 Sheets কনফিগারেশন যার একটি পরিসর (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 সেট করুন। যদি সেট করা থাকে, তাহলে প্রদত্ত Looker কনফিগারেশন দিয়ে ডেটা উৎস প্রতিস্থাপন করে। Replace বনাম update দেখুন।
ds. alias .instanceUrl	** লুকার ইনস্ট্যান্স URL প্রয়োজন ।
ds. alias .model	** লুকার মডেল প্রয়োজন ।
ds. alias .explore	** দ্য লুকার এক্সপ্লোর।
ds. alias .refreshFields	ঐচ্ছিক। নির্দিষ্ট না থাকলে ডিফল্টভাবে false । বিস্তারিত জানার জন্য রিফ্রেশফিল্ড দেখুন।

উদাহরণ

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

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

উদাহরণ

URL-prefix প্রপার্টির জন্য একটি Search Console কনফিগারেশন:

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 এর মাধ্যমে প্রতিস্থাপন করা হচ্ছে, তাই দেখার অ্যাক্সেসের প্রয়োজন নেই।
পুনর্ব্যবহারযোগ্য	আপডেট	ব্যবহারকারীদের দেখার অ্যাক্সেস প্রয়োজন।	টেমপ্লেট ডেটা সোর্স থেকে কনফিগারেশনটি পড়তে এবং ব্যবহার করতে লিঙ্কিং API-এর জন্য ডেটা সোর্সে ভিউ অ্যাক্সেস প্রয়োজন। যদি ব্যবহারকারীদের ভিউ অ্যাক্সেস না থাকে তবে তারা রিপোর্ট লোড করার সময় একটি ত্রুটি পাবেন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

রিপোর্ট আইডি

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

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

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

রিপোর্ট URL-এ রিপোর্ট আইডি খুঁজুন।

ডেটা সোর্স উপনাম

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

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

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

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

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

সংযোগকারীর ধরণ

একটি রিপোর্টে একাধিক ডেটা সোর্স থাকতে পারে, প্রতিটি একটি কানেক্টর কনফিগার করে তৈরি করা হয়। ডেটা সোর্স তৈরি করতে ব্যবহৃত কানেক্টরের ধরণ খুঁজে বের করতে:

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

ডেটা সোর্স ম্যানেজমেন্ট পৃষ্ঠায় ডেটা সোর্স সংযোগকারীর ধরণটি খুঁজুন।

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

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

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

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

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

  

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

অনুমতিসমূহ

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

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

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

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

ক্ষেত্রগুলি রিফ্রেশ করুন

যদি আপনি কোনও টেমপ্লেট ডেটা সোর্সের জন্য ফিল্ডের নাম, ধরণ বা সমষ্টি কনফিগার করে থাকেন, তাহলে এই পরিবর্তনগুলি কেবল তখনই একটি Linking API কনফিগার করা ডেটা সোর্সে স্থানান্তরিত হবে যদি ds.refreshFields প্যারামিটারটি false তে সেট করা থাকে।

আপনার Linking 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 .

প্রতিক্রিয়া এবং সমর্থন

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

পরিবর্তণ

২০২৩-০৬-০৬

• 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.

২০২৩-০৫-২২

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

২০২২-১১-২১

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

২০২২-১১-১৪

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

২০২২-০৬-১৫

• 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.
• গুগল শিটস
  • 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.

২০২১-১২-১৬

• 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.