نمای کلی

می‌توانید بخش‌های داده را با استفاده از Authorized Buyers Marketplace API ایجاد و مدیریت کنید که منبع curators.dataSegments را نشان می‌دهد. این یک API REST با کتابخانه های مشتری تولید شده است که می توانید برای یکپارچه سازی خود از آن استفاده کنید.

احراز هویت را تنظیم کنید

API های Google از پروتکل OAuth 2.0 برای احراز هویت و مجوز استفاده می کنند. در اینجا نحوه راه اندازی یک حساب سرویس برای دسترسی به API Marketplace آورده شده است.

  1. اگر قبلاً این کار را انجام نداده‌اید، یک پروژه Google Cloud ایجاد کنید که اعتبارنامه‌های مورد استفاده شما برای دسترسی به API را میزبانی کند.
  2. به صفحه Google Cloud Console Enabled APIs بروید. پروژه ای را که قبلا ایجاد کرده اید انتخاب کنید.

  3. لیستی از API ها و سرویس های فعال را مشاهده می کنید. برای دسترسی به API Marketplace، باید آن را فعال کنید. اگر Marketplace API فعال نیست، روی +Enable APIs and services کلیک کنید و دستورالعمل‌های زیر را طی کنید:

    1. شما به صفحه ای با کادر جستجو هدایت می شوید. API بازار خرید مجاز را جستجو کنید.
    2. API Authorized Buyers Marketplace را در صفحه نتایج انتخاب کنید.
    3. روی Enable کلیک کنید.
  4. در منوی پیمایش، اعتبارنامه ها را انتخاب کنید.
  5. روی +Create credentials کلیک کنید و در منوی کشویی ایجاد شده گزینه Service account را انتخاب کنید.
  6. یک نام برای حساب سرویس وارد کنید. شناسه حساب سرویس به‌طور خودکار پس از ایجاد ایجاد می‌شود - به این مقدار توجه کنید زیرا بعداً در مرحله 14 مورد نیاز خواهد بود. در صورت تمایل، یک توضیح وارد کنید. روی ایجاد و ادامه کلیک کنید.
  7. به صورت اختیاری مجوزها را برای حساب سرویس پیکربندی کنید و روی Continue کلیک کنید.
  8. به صورت اختیاری کاربران یا گروه‌هایی را پیکربندی کنید که می‌توانند اقداماتی را به عنوان حساب سرویس انجام دهند و روی انجام شد کلیک کنید.
  9. حساب سرویس جدید شما در بخش حساب‌های خدمات فهرست شده است. شناسه حساب سرویسی را که ایجاد کردید پیدا کنید و روی آن کلیک کنید.
  10. روی تب Keys کلیک کنید.
  11. در منوی کشویی کلید افزودن ، ایجاد کلید جدید را انتخاب کنید.
  12. JSON را به عنوان نوع کلید انتخاب کنید و روی Create کلیک کنید.
  13. کلید دایرکتوری کاری خود را دانلود کنید. برای اطلاعات بیشتر در مورد ذخیره ایمن کلید خود، به مدیریت کلیدهای حساب سرویس مراجعه کنید. کلید توسط برنامه شما برای برقراری تماس های API استفاده می شود.
  14. شناسه حساب سرویس را با مدیر حساب فنی خود به اشتراک بگذارید تا حساب سرویس را با حساب خود پیوند دهید.

دامنه های API

هنگام عبور از جریان OAuth 2.0 برای دریافت رمز دسترسی مورد استفاده برای برقراری تماس API، باید API هایی را مشخص کنید که با استفاده از آن نشانه می توان به آنها دسترسی داشت. برای API بازار مجاز خریداران، این محدوده https://www.googleapis.com/auth/authorized-buyers-marketplace است.

نحوه شناسایی بخش‌های داده در API در مقابل مدیریت زمان واقعی

در Marketplace API، بخش‌های داده با نام منبع خاص API مانند:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

هنگام شناسایی بخش‌های داده مربوط به یک فرصت تبلیغاتی در Curation بلادرنگ ، مقدار شناسه منبع DATA_SEGMENT_ID را به جای name کامل منبع مورد استفاده توسط API مشخص کنید.

مراحل بعدی