نمای کلی

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

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

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

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

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

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

    1. شما به صفحه‌ای با کادر جستجو هدایت می‌شوید. عبارت Authorized Buyers Marketplace API را جستجو کنید.
    2. در صفحه نتایج، گزینه Authorized Buyers Marketplace API را انتخاب کنید.
    3. روی فعال کردن کلیک کنید.

  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 مربوط به بازار خریداران مجاز، این محدوده https://www.googleapis.com/auth/authorized-buyers-marketplace است.

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

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

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

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

مراحل بعدی