API লিঙ্ক করা

ভূমিকা

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

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

ব্যবহারের ক্ষেত্র এবং সুবিধাসমূহ

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

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

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

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

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

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

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

এপিআই ব্যবহারকারীর অভিজ্ঞতা সংযুক্ত করা

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

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

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

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

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

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

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

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

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

উদাহরণ ইউআরএল

নিম্নলিখিতটি একটি লিঙ্কিং এপিআই ইউআরএল-এর উদাহরণ। রিপোর্টের নাম সেট করা আছে এবং একটিমাত্র বিগকোয়েরি ডেটা সোর্স কনফিগার করা হয়েছে:

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 নির্ধারণ করতে ব্যবহৃত প্যারামিটারগুলোর একটি তালিকা নিচে দেওয়া হলো:

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

লিঙ্কিং এপিআই ইউআরএল-এর মাধ্যমে রিপোর্টটি দেখার সময় এর অবস্থা নিয়ন্ত্রণ প্যারামিটারগুলো নির্ধারণ করে।

প্যারামিটার নাম বর্ণনা
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

ঐচ্ছিক। রিপোর্টের ব্যবহার পরিমাপ করার জন্য গুগল অ্যানালিটিক্স মেজারমেন্ট আইডিগুলো সেট করে। একাধিক আইডি আলাদা করতে কমা ব্যবহার করুন।

যদি r.measurementId এবং r.keepMeasurementId নির্দিষ্ট করা না থাকে, তাহলে Google Analytics Measurement IDs রিপোর্ট সেটিংটি ডিফল্টরূপে অনির্ধারিত থাকে। যদি r.measurementId এবং r.keepMeasurementId সেট করা থাকে, তাহলে আইডি সেট করার ক্ষেত্রে r.keepMeasurementId অগ্রাধিকার পায়।

r.keepMeasurementId

ঐচ্ছিক। টেমপ্লেট রিপোর্ট 'গুগল অ্যানালিটিক্স মেজারমেন্ট আইডি ' ব্যবহার করতে এটিকে ' true সেট করুন। নির্দিষ্ট না করা হলে ডিফল্টরূপে ' false থাকবে।

যদি r.measurementId এবং r.keepMeasurementId নির্দিষ্ট করা না থাকে, তাহলে Google Analytics Measurement IDs রিপোর্ট সেটিংটি ডিফল্টরূপে অনির্ধারিত থাকে। যদি 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 কীভাবে খুঁজে বের করতে হয়, সে সম্পর্কে বিস্তারিত জানতে ডেটা সোর্স অ্যালিয়াস দেখুন।

ডেটা উৎসের পরামিতি

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

নাম বর্ণনা
ds. alias .datasourceName

ঐচ্ছিক। ডেটা উৎসের নাম নির্ধারণ করে।

যদি ds.datasourceName এবং ds.keepDatasourceName নির্দিষ্ট করা না থাকে, তাহলে ডেটা সোর্স নামটি ডিফল্টরূপে এমন একটি নামকরণ পদ্ধতি অনুসরণ করে যেখানে কানেক্টরের ধরন এবং তৈরির সময় অন্তর্ভুক্ত থাকে (যেমন samples - 12/12/21, 10:53 PM )। যদি ds.datasourceName এবং ds.keepDatasourceName সেট করা থাকে, তাহলে ডেটা সোর্স নাম সেট করার ক্ষেত্রে ds.datasourceName অগ্রাধিকার পায়।

ds. alias .keepDatasourceName

ঐচ্ছিক। টেমপ্লেট ডেটা সোর্স নামটি ব্যবহার করতে এটিকে ' true সেট করুন। নির্দিষ্ট না করা হলে ডিফল্টরূপে ' false থাকবে।

যদি ds.datasourceName এবং ds.keepDatasourceName নির্দিষ্ট করা না থাকে, তাহলে ডেটা সোর্স নামটি ডিফল্টরূপে এমন একটি নামকরণ পদ্ধতি অনুসরণ করে যেখানে কানেক্টরের ধরন এবং তৈরির সময় অন্তর্ভুক্ত থাকে (যেমন samples - 12/12/21, 10:53 PM )। যদি ds.datasourceName এবং ds.keepDatasourceName সেট করা থাকে, তাহলে ডেটা সোর্স নাম সেট করার ক্ষেত্রে ds.datasourceName অগ্রাধিকার পায়।

ds. alias .connector
ঐচ্ছিক।

ডেটা সোর্সের কানেক্টর টাইপ। সমর্থিত কানেক্টর টাইপগুলো সম্পর্কে আরও তথ্যের জন্য, কানেক্টর রেফারেন্স দেখুন।

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

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

একটি টেমপ্লেট ডেটা সোর্স কনফিগারেশন সম্পূর্ণরূপে প্রতিস্থাপিত হবে নাকি অনির্দিষ্ট প্যারামিটার আপডেট করতে ব্যবহৃত হবে, তা ds.connector প্যারামিটার কীভাবে প্রভাবিত করে সে সম্পর্কে আরও জানতে, Replace vs update দেখুন।

ds. alias .refreshFields
ঐচ্ছিক।

লিঙ্কিং এপিআই (Linking API)-এর মাধ্যমে নির্দিষ্ট করা ডেটা সোর্স কনফিগারেশন ব্যবহার করে ডেটা সোর্স ফিল্ড রিফ্রেশ করতে এবং নতুন ফিল্ড নির্বাচনের মাধ্যমে রিপোর্ট কম্পোনেন্ট আপডেট করতে এটিকে ' true সেট করুন। সাধারণত কানেক্টর টাইপ পরিবর্তন করার সময় অথবা এমন কানেক্টর টাইপের জন্য true নির্দিষ্ট করা হয়, যেখানে কনফিগারেশন পরিবর্তনের ফলে ভিন্ন ফিল্ড তৈরি হয় (যেমন, BigQuery ডেটা সোর্সের ফিল্ডগুলো প্রায়শই বিভিন্ন টেবিল কনফিগারেশনের সাথে পরিবর্তিত হয়)।

টেমপ্লেট রিপোর্ট থেকে ডেটা সোর্স ফিল্ডগুলো অপরিবর্তিত রাখতে ' false সেট করুন। সাধারণত false তখনই নির্দিষ্ট করা হয়, যখন নতুন ডেটা কনফিগারেশনে হুবহু একই ফিল্ড পাওয়া যায় এবং আপনি টেমপ্লেট ডেটা সোর্সে করা যেকোনো ফিল্ড পরিবর্তন বজায় রাখতে চান।

অনির্দিষ্ট থাকলে, ডিফল্ট মান কানেক্টরের ধরন অনুযায়ী পরিবর্তিত হয়। আপনি যদি ডিফল্ট আচরণ পরিবর্তন করতে চান, তবে কানেক্টর-নির্দিষ্ট ডিফল্ট মান জানার জন্য কানেক্টর রেফারেন্স পর্যালোচনা করুন।

refreshFields ব্যবহার করার সময় বিবেচ্য বিষয়সমূহ:
  • যদি refreshFields false সেট করা হয় এবং লিঙ্কিং এপিআই (Linking API)-এর মাধ্যমে নির্দিষ্ট করা ডেটা সোর্স কনফিগারেশন থেকে টেমপ্লেট রিপোর্টে ব্যবহৃত ফিল্ডগুলো ভিন্ন হয়, তাহলে ব্যবহারকারী সম্ভবত প্রভাবিত কম্পোনেন্টগুলোর জন্য একটি কনফিগারেশন ত্রুটি দেখতে পাবেন।
  • টেমপ্লেট ডেটা সোর্সের ফিল্ডগুলিতে করা পরিবর্তন (যেমন নাম, টাইপ, অ্যাগ্রিগেশন, ইত্যাদি) নতুন ডেটা সোর্সে স্থানান্তরিত হয় না , যখন refreshFields true সেট করা থাকে। টেমপ্লেট ডেটা সোর্স থেকে ফিল্ড কনফিগারেশন বজায় রাখতে refreshFields কে false সেট করুন।
  • টেমপ্লেট ডেটা সোর্সে সংজ্ঞায়িত ক্যালকুলেটেড ফিল্ড এবং প্যারামিটারগুলো সর্বদা নতুন তৈরি ডেটা সোর্সে কপি করা হবে এবং refreshFields এর মান দ্বারা প্রভাবিত হবে না।
ds. alias .connectorParameters
প্রয়োজনীয়কানেক্টর টাইপের জন্য ডেটা সোর্স কনফিগারেশন। ডেটা সোর্স তৈরি করতে ব্যবহৃত কানেক্টরটি কীভাবে শনাক্ত করতে হয়, সে সম্পর্কে বিস্তারিত জানতে ‘কানেক্টর টাইপ’ দেখুন। প্রতিটি কানেক্টর টাইপের জন্য উপলব্ধ ডেটা সোর্স প্যারামিটার সম্পর্কে বিস্তারিত জানতে ‘ কানেক্টর রেফারেন্স’ দেখুন।

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

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

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

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

এটি লিঙ্কিং এপিআই ইউআরএল (Linking API URL)-কে সরল করে এবং সাধারণত তখনই এটি ব্যবহার করার পরামর্শ দেওয়া হয়, যখন আপনি টেমপ্লেট ডেটা সোর্স কনফিগারেশনের সাথে পরিচিত থাকেন ও শুধুমাত্র কিছু প্যারামিটার ওভাররাইড করতে চান।
  • যখন আপনি শুধুমাত্র এমন প্যারামিটার মান প্রদান করতে চান যা টেমপ্লেট ডেটা সোর্স থেকে ভিন্ন, এবং যেকোনো অনির্দিষ্ট কানেক্টর প্যারামিটারের জন্য টেমপ্লেট ডেটা সোর্সের উপর নির্ভর করতে আপনার আপত্তি নেই। যেমন, একটি BigQuery ডেটা সোর্স কনফিগারেশনের শুধুমাত্র বিলিং প্রজেক্ট আইডি পরিবর্তন করুন এবং অন্য সব প্যারামিটারের জন্য টেমপ্লেট কনফিগারেশন ব্যবহার করুন।

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

যদি কোনো ডেটা সোর্সের ds.connector প্যারামিটার নির্দিষ্ট করা থাকে, তাহলে সেই ডেটা সোর্সের জন্য Required হিসেবে চিহ্নিত সমস্ত কানেক্টর প্যারামিটার অবশ্যই নির্দিষ্ট করতে হবে। যদি ডেটা সোর্সের ds.connector প্যারামিটারটি অনির্দিষ্ট থাকে, তাহলে অন্যথা বলা না থাকলে, Required হিসেবে চিহ্নিত প্যারামিটারগুলো সহ সমস্ত কানেক্টর প্যারামিটারকে ঐচ্ছিক হিসেবে গণ্য করা যেতে পারে।

উদাহরণ

একটিমাত্র 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

তৈরি বনাম যোগ

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

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

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

ডেটা উৎসের বিকল্প নাম ওয়াইল্ডকার্ড

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

এটি আপনার ইউআরএল থেকে পুনরাবৃত্তিমূলক প্যারামিটার বাদ দেওয়ার জন্য কার্যকর হতে পারে। উদাহরণস্বরূপ, যদি আপনার কাছে তিনটি BigQuery ডেটা সোর্স সংযুক্ত একটি টেমপ্লেট থাকে, এবং আপনি প্রতিটির projectIddatasetId প্রতিস্থাপন করতে চান, কিন্তু 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.* ওয়াইল্ডকার্ড ব্যবহার করে আপনি এই সমতুল্য ইউআরএলটি ব্যবহার করতে পারেন:

  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. প্যারামিটারটির ডিফল্ট মান, যদি এটি ঐচ্ছিক হয়।

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

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

বিগকোয়েরি

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

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

নাম বর্ণনা
ds. alias .gaTemplateLevel
ঐচ্ছিক। ব্যবহারের জন্য গুগল অ্যানালিটিক্স ফিল্ড টেমপ্লেট। শুধুমাত্র তখনই প্রযোজ্য যখন গুগল অ্যানালিটিক্স টেবিলের জন্য একটি BigQuery এক্সপোর্ট কোয়েরি করা হচ্ছে। ALL , SESSION , HITS এর মধ্যে যেকোনো একটি। গুগল অ্যানালিটিক্স টেবিলের ক্ষেত্রে, নির্দিষ্ট না করা হলে ডিফল্টরূপে ALL ব্যবহৃত হয়।
ds. alias .firebaseTemplateLevel
ঐচ্ছিক। ব্যবহারের জন্য ফায়ারবেস অ্যানালিটিক্স ফিল্ড টেমপ্লেট। শুধুমাত্র তখনই প্রযোজ্য যখন ফায়ারবেস অ্যানালিটিক্স টেবিলের জন্য একটি বিগকোয়েরি এক্সপোর্ট কোয়েরি করা হচ্ছে। শুধুমাত্র EVENTS এ সেট করা যাবে। ফায়ারবেস অ্যানালিটিক্স টেবিলের ক্ষেত্রে, অনির্দিষ্ট থাকলে ডিফল্টরূপে EVENTS ব্যবহৃত হয়।
ds. alias .crashlyticsTemplateLevel
ব্যবহার করার জন্য ফায়ারবেস ক্র্যাশলিটিক্স ফিল্ড টেমপ্লেট। এটি শুধুমাত্র DEFAULT এ সেট করা যাবে। এটি শুধুমাত্র তখনই প্রযোজ্য যখন ফায়ারবেস ক্র্যাশলিটিক্স টেবিলের জন্য কোনো BigQuery এক্সপোর্ট কোয়েরি করা হয়। ফায়ারবেস ক্র্যাশলিটিক্স টেবিলের ক্ষেত্রে, অনির্দিষ্ট থাকলে এটি ডিফল্টরূপে 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 ফিল্ড টেমপ্লেট ব্যবহার করে, গুগল অ্যানালিটিক্সের জন্য বিগকোয়েরি এক্সপোর্ট করা একটি টেবিল কোয়েরি করার জন্য একটি 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
ঐচ্ছিক। গুগল অ্যানালিটিক্স কানেক্টরের জন্য এটিকে googleAnalytics এ সেট করুন।

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

উদাহরণ

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

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 গুগল ক্লাউড স্টোরেজ কানেক্টর- এ সেট করুন।

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

উদাহরণ

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

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

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

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
ঐচ্ছিক। গুগল শিটস কানেক্টরের জন্য এটিকে googleSheets এ সেট করুন।

সেট করা থাকলে, প্রদত্ত গুগল শিটস কনফিগারেশন দিয়ে ডেটা সোর্সটি প্রতিস্থাপন করা হয়। প্রতিস্থাপন বনাম আপডেট দেখুন।
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

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

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

একটি গুগল শিটস কনফিগারেশন যেখানে একটি রেঞ্জ (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
প্রয়োজনীয় ** লুকার ইনস্ট্যান্স ইউআরএল।
ds. alias .model
প্রয়োজনীয় ** লুকার মডেল।
ds. alias .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

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

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

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

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

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

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

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

ডিফল্ট রিপোর্টটি ডেটা স্টুডিও দ্বারা সরবরাহ করা হয়।

ডিফল্ট রিপোর্টের জন্য ডেটা সোর্স প্যারামিটার নির্দিষ্ট করার সময় ডেটা সোর্স অ্যালিয়াস ব্যবহার করার প্রয়োজন নেই, কারণ ডিফল্ট রিপোর্টে একটিমাত্র এমবেডেড ডেটা সোর্স রয়েছে।

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

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

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

একটি প্রতিবেদন সংযুক্ত করুন

লিঙ্কিং এপিআই দিয়ে তৈরি একটি রিপোর্ট এমবেড করতে, ইউআরএল প্যারামিটার সেট করুন এবং /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 দেখা যাচ্ছে। রিপোর্ট আইডি হাইলাইট করা আছে।
রিপোর্ট URL-এ রিপোর্ট আইডিটি খুঁজুন।

ডেটা উৎসের বিকল্প নাম

একটি রিপোর্টে একাধিক ডেটা সোর্স থাকতে পারে। ডেটা সোর্সকে তার অ্যালিয়াস (alias) দ্বারা উল্লেখ করতে হবে।

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

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

কোনো ডেটা সোর্স যোগ বা অপসারণ করার সময় পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যতা নিশ্চিত করতে আপনি অ্যালিয়াস নামগুলো সম্পাদনা করতে পারেন।

ডেটা সোর্স রিসোর্স ম্যানেজমেন্ট পেজে ডেটা সোর্সসমূহের একটি তালিকা। অ্যালিয়াস কলামটি হাইলাইট করা আছে।
ডেটা সোর্স ম্যানেজমেন্ট পেজে ডেটা সোর্স অ্যালিয়াসটি খুঁজুন।

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

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

  1. প্রতিবেদনটি সম্পাদনা করুন।
  2. টুলবার থেকে, রিসোর্স > যোগ করা ডেটা উৎসসমূহ পরিচালনা নির্বাচন করুন।
  3. ডেটা সোর্স তৈরি করতে ব্যবহৃত কানেক্টরটি শনাক্ত করতে কানেক্টর টাইপ কলামটি পরীক্ষা করুন।
ডেটা সোর্স রিসোর্স ম্যানেজমেন্ট পেজে ডেটা সোর্সসমূহের একটি তালিকা। ‘কানেক্টর টাইপ’ কলামটি হাইলাইট করা আছে।
ডেটা সোর্স ম্যানেজমেন্ট পেজে ডেটা সোর্স কানেক্টর টাইপটি খুঁজুন।

টিপস ও সমস্যা সমাধান

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

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

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

  • লিঙ্কিং এপিআই ইউআরএল পার্স করার সময় কোনো ত্রুটি দেখা দিলে, ত্রুটিটির বিবরণসহ একটি ডায়ালগ স্বয়ংক্রিয়ভাবে প্রদর্শিত হবে।
  • যখন কোনো ত্রুটি ঘটে এবং স্বয়ংক্রিয়ভাবে কোনো ডায়ালগ বক্স প্রদর্শিত না হয়, তখন রিপোর্টের উপরের ডানদিকে থাকা তথ্য বোতামটি খুঁজুন। অতিরিক্ত ডিবাগ তথ্যের জন্য ক্লিক করুন।
    একটি রিপোর্ট কীভাবে তৈরি করা হয়েছিল তা জানার জন্য একটি তথ্য বাটন।
  • যদি কোনো তথ্য বাটন না থাকে, তাহলে যেকোনো লিঙ্কিং এপিআই ইউআরএল-এর শেষে &c.explain=true প্যারামিটারটি যুক্ত করে আপনি বাটনটি সক্রিয় করতে পারেন।

অনুমতি

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

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

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

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

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

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

Review the ds.refreshFields data source parameter of your Linking API URL. If omitted, confirm that the default value of the parameter for each connector type is correct for your use case.

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, Data 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.

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.

পরিবর্তন তালিকা

2023-06-06

2023-05-22

২০২২-১১-২১

2022-11-14

২০২২-০৬-১৫

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