شروع به کار

شما می‌توانید از API آژانس‌ها و برندها برای تولید گزارش‌هایی استفاده کنید که می‌توانند بینش‌هایی در مورد عملکرد حساب آژانس شما ارائه دهند.

حساب‌های آژانس

یک حساب کاربری آژانس، آژانس‌های تبلیغاتی را نشان می‌دهد که با ناشران Google Ad Manager تعامل دارند. می‌توانید شناسه حساب کاربری آژانس خود را با مشاهده رابط کاربری آژانس هنگام ورود به حساب Google خود پیدا کنید.

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

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

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

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

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

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

    gcloud services enable agenciesandbrands.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 را مشخص کنید:

https://www.googleapis.com/auth/agencies-and-brands

مراحل بعدی