نمای کلی

شما می‌توانید با استفاده از API مربوط به Curation Partners ، که منبعی به نام curators.dataSegments را در اختیار شما قرار می‌دهد، بخش‌های داده را ایجاد و مدیریت کنید. این یک API REST با کتابخانه‌های کلاینت تولید شده است که می‌توانید برای ادغام خود از آنها استفاده کنید.

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

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

  1. اگر قبلاً این کار را نکرده‌اید، یک پروژه Google Cloud ایجاد کنید که میزبان اعتبارنامه‌های شما برای دسترسی به API باشد.

  2. به صفحه APIهای فعال‌شده در کنسول ابری گوگل بروید. پروژه‌ای را که قبلاً ایجاد کرده‌اید انتخاب کنید.

  3. لیست APIها و سرویس‌های فعال را بررسی کنید. برای دسترسی به API مربوط به Curation Partners، باید آن را فعال کنید. اگر API مربوط به Curation Partners فعال نیست، روی +فعال کردن APIها و سرویس‌ها کلیک کنید و دستورالعمل‌های زیر را دنبال کنید:

    1. با استفاده از کادر جستجو، API مربوط به Curation Partners را جستجو کنید.
    2. در صفحه نتایج، گزینه Curation Partners API را انتخاب کنید.
    3. روی فعال کردن کلیک کنید.

    این یک مشکل شناخته شده است که ممکن است نتوانید API مربوط به Curation Partners را با کادر جستجوی کنسول Google Cloud پیدا کنید. به عنوان یک جایگزین، می‌توانید از Google Cloud CLI برای فعال کردن API استفاده کنید. پس از نصب gcloud CLI، می‌توانید API مربوط به Curation Partners را با دستور زیر فعال کنید:

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

  4. در منوی پیمایش، اعتبارنامه‌ها را انتخاب کنید.

  5. روی +Create credentials کلیک کنید و در منوی کشویی حاصل، Service account را انتخاب کنید.

  6. یک نام برای حساب سرویس وارد کنید. شناسه حساب سرویس به طور خودکار هنگام ایجاد ایجاد می‌شود - این مقدار را یادداشت کنید زیرا بعداً در مرحله ۱۴ به آن نیاز خواهید داشت. در صورت تمایل، توضیحی وارد کنید. روی ایجاد و ادامه کلیک کنید.

  7. در صورت تمایل، مجوزهای حساب سرویس را پیکربندی کنید و روی ادامه کلیک کنید.

  8. در صورت تمایل، کاربران یا گروه‌هایی را که می‌توانند اقداماتی را به عنوان حساب سرویس انجام دهند، پیکربندی کنید و روی «انجام شد» کلیک کنید.

  9. حساب سرویس جدید شما در بخش حساب‌های سرویس (Service Accounts) فهرست شده است. شناسه حساب سرویسی که ایجاد کرده‌اید را پیدا کرده و روی آن کلیک کنید.

  10. روی برگه کلیدها کلیک کنید.

  11. در منوی کشویی «افزودن کلید» ، «ایجاد کلید جدید» را انتخاب کنید.

  12. نوع کلید را JSON انتخاب کنید و روی Create کلیک کنید.

  13. کلید را در دایرکتوری کاری خود دانلود کنید. برای اطلاعات بیشتر در مورد ذخیره ایمن کلید خود، به مدیریت کلیدهای حساب سرویس مراجعه کنید. این کلید توسط برنامه شما برای برقراری تماس‌های API استفاده می‌شود.

  14. شناسه حساب سرویس را با مدیر حساب فنی خود به اشتراک بگذارید تا حساب سرویس به حساب شما متصل شود.

دامنه‌های API

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

نحوه شناسایی بخش‌های داده در API در مقابل گردآوری بلادرنگ

در API شرکای Curation، بخش‌های داده با نام منبع مختص به API مانند موارد زیر شناسایی می‌شوند:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

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

مراحل بعدی