ওভারভিউ

আপনি কিউরেশন পার্টনার্স এপিআই (Curation Partners API) ব্যবহার করে ডেটা সেগমেন্ট তৈরি ও পরিচালনা করতে পারেন, যা একটি curators.dataSegments রিসোর্স প্রদান করে। এটি একটি REST API, যার সাথে জেনারেটেড ক্লায়েন্ট লাইব্রেরি রয়েছে যা আপনি আপনার ইন্টিগ্রেশনের জন্য ব্যবহার করতে পারেন।

প্রমাণীকরণ সেট আপ করুন

গুগল এপিআই প্রমাণীকরণ এবং অনুমোদনের জন্য OAuth 2.0 প্রোটোকল ব্যবহার করে। কিউরেশন পার্টনার্স এপিআই অ্যাক্সেস করার জন্য কীভাবে একটি সার্ভিস অ্যাকাউন্ট সেট আপ করবেন, তা এখানে দেওয়া হলো।

  1. যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন যেখানে এপিআই অ্যাক্সেস করার জন্য ব্যবহৃত আপনার ক্রেডেনশিয়ালগুলো থাকবে।

  2. Google Cloud Console-এর Enabled APIs পৃষ্ঠায় যান। আপনার পূর্বে তৈরি করা প্রজেক্টটি নির্বাচন করুন।

  3. সক্রিয় করা এপিআই এবং সার্ভিসগুলোর তালিকা পর্যালোচনা করুন। কিউরেশন পার্টনারস এপিআই অ্যাক্সেস করতে হলে, আপনাকে অবশ্যই এটি সক্রিয় করতে হবে। যদি কিউরেশন পার্টনারস এপিআই সক্রিয় করা না থাকে, তাহলে ‘+এপিআই এবং সার্ভিসগুলো সক্রিয় করুন’ (+Enable APIs and services) -এ ক্লিক করুন এবং নিচের নির্দেশাবলী অনুসরণ করুন:

    1. সার্চ বক্স ব্যবহার করে কিউরেশন পার্টনারস এপিআই (Curation Partners API) অনুসন্ধান করুন।
    2. ফলাফল পৃষ্ঠায় কিউরেশন পার্টনারস এপিআই নির্বাচন করুন।
    3. সক্ষম করুন -এ ক্লিক করুন।

    এটি একটি পরিচিত সমস্যা যে আপনি গুগল ক্লাউড কনসোল সার্চ বক্সে কিউরেশন পার্টনারস এপিআই (Curation Partners API) খুঁজে নাও পেতে পারেন। এর বিকল্প হিসেবে, আপনি এপিআইটি সক্রিয় করতে গুগল ক্লাউড সিএলআই (Google Cloud CLI) ব্যবহার করতে পারেন। gcloud CLI ইনস্টল করার পরে, আপনি নিম্নলিখিত কমান্ডের মাধ্যমে কিউরেশন পার্টনারস এপিআই সক্রিয় করতে পারেন:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. নেভিগেশন মেনু থেকে ক্রেডেনশিয়ালস নির্বাচন করুন।

  5. +Create credentials-এ ক্লিক করুন, এবং ফলস্বরূপ ড্রপ-ডাউন মেনু থেকে Service account নির্বাচন করুন।

  6. সার্ভিস অ্যাকাউন্টের জন্য একটি নাম লিখুন। তৈরির সময় সার্ভিস অ্যাকাউন্ট আইডি স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায় – এই মানটি লিখে রাখুন কারণ এটি পরে ১৪ নম্বর ধাপে প্রয়োজন হবে। ইচ্ছা হলে একটি বিবরণ লিখুন। 'তৈরি করুন এবং চালিয়ে যান'- এ ক্লিক করুন।

  7. ঐচ্ছিকভাবে সার্ভিস অ্যাকাউন্টের জন্য অনুমতি কনফিগার করুন এবং 'চালিয়ে যান'-এ ক্লিক করুন।

  8. ঐচ্ছিকভাবে সেইসব ব্যবহারকারী বা গোষ্ঠী কনফিগার করুন যারা পরিষেবা অ্যাকাউন্ট হিসাবে কাজগুলি সম্পাদন করতে পারবে এবং 'সম্পন্ন' ক্লিক করুন।

  9. আপনার নতুন সার্ভিস অ্যাকাউন্টটি ‘সার্ভিস অ্যাকাউন্টস’-এর অধীনে তালিকাভুক্ত আছে। আপনি এইমাত্র তৈরি করা সার্ভিস অ্যাকাউন্ট আইডিটি খুঁজুন এবং ক্লিক করুন।

  10. Keys ট্যাবে ক্লিক করুন।

  11. Add key ড্রপ-ডাউন মেনু থেকে Create new key নির্বাচন করুন।

  12. Key type হিসেবে JSON নির্বাচন করুন এবং Create-এ ক্লিক করুন।

  13. কী-টি আপনার ওয়ার্কিং ডিরেক্টরিতে ডাউনলোড করুন। আপনার কী নিরাপদে সংরক্ষণ করার বিষয়ে আরও তথ্যের জন্য, ‘সার্ভিস অ্যাকাউন্ট কী পরিচালনা’ দেখুন। আপনার অ্যাপ্লিকেশন এপিআই (API) কল করার জন্য এই কী-টি ব্যবহার করে।

  14. আপনার অ্যাকাউন্টের সাথে সার্ভিস অ্যাকাউন্টটি লিঙ্ক করার জন্য, সার্ভিস অ্যাকাউন্ট আইডিটি আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজারের সাথে শেয়ার করুন।

এপিআই স্কোপ

এপিআই কল করার জন্য ব্যবহৃত অ্যাক্সেস টোকেন পেতে OAuth 2.0 ফ্লো অনুসরণ করার সময়, আপনাকে অবশ্যই সেই এপিআইগুলো নির্দিষ্ট করে দিতে হবে যেগুলো ওই টোকেন ব্যবহার করে অ্যাক্সেস করা যাবে। কিউরেশন পার্টনার্স এপিআই-এর জন্য, সেই স্কোপটি হলো https://www.googleapis.com/auth/curation-partners ।

এপিআই এবং রিয়েল-টাইম কিউরেশনে ডেটা সেগমেন্টগুলি কীভাবে শনাক্ত করবেন

কিউরেশন পার্টনার্স এপিআই-তে, ডেটা সেগমেন্টগুলিকে একটি এপিআই-নির্দিষ্ট রিসোর্স নাম দিয়ে চিহ্নিত করা হয়, যেমন:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

রিয়েল-টাইম কিউরেশনে কোনো বিজ্ঞাপনের সুযোগের জন্য প্রাসঙ্গিক ডেটা সেগমেন্ট শনাক্ত করার সময়, name ফিল্ডে API দ্বারা প্রদত্ত সম্পূর্ণ রিসোর্স নামের পরিবর্তে DATA_SEGMENT_ID রিসোর্স আইডি-র মান উল্লেখ করুন।

পরবর্তী পদক্ষেপ