نصب DV360 Exchange Reporting API و راه‌اندازی OAuth

DV360 Exchange Reporting API به‌عنوان یک API Google Cloud مبتنی بر لیست مجاز که از OAuth استفاده می‌کند در معرض دید قرار می‌گیرد. فرآیند لیست مجاز توسط تیم DV360 Exchange Reporting API مدیریت می شود.

رویه

مراحل نصب DV360 Exchange Reporting API در اینجا آمده است:

  1. یک حساب Google در کنسول Google Cloud ثبت کنید.

    توجه داشته باشید که این حساب قرار است برای مدیریت نشانه‌های دسترسی مشتری تولیدی خود استفاده شود، بنابراین از حساب شخصی جیمیل خود استفاده نکنید.

  2. با اطلاعات حساب Google DV360 تماس بگیرید تا آن را به لیست مجاز اضافه کنید.

  3. پس از اینکه به شما اطلاع داده شد که در لیست مجاز هستید، درخواست بررسی تأیید OAuth کنید تا برنامه خود را به محدوده doubleclickbidmanager دسترسی پیدا کنید.

  4. در کنسول Google Cloud وارد سیستم شوید.

    به API & Services > Library > Private بروید. باید یک API گزارش تبادل DV360 را ببینید که به عنوان یکی از APIهای موجود در دسترس شما است. DV360 Exchange Reporting API را فعال کنید.

  5. به Credentials > Create a Credential > Key Account Service بروید. دستورالعمل ها را برای ایجاد یک حساب سرویس دنبال کنید.

حساب خدمات

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

در اینجا مراحل ایجاد اعتبار حساب سرویس با استفاده از کنسول Google Cloud آمده است:

  1. از صفحه مدیر API > اعتبارنامه ، ایجاد اعتبار → کلید حساب سرویس را انتخاب کنید.

  2. حساب کاربری جدید را از منوی کشویی حساب سرویس انتخاب کنید.

    یک نام برای این حساب سرویس وارد کنید. این نام به عنوان نام پیش‌فرض برای شناسه حساب سرویس شما، در سمت چپ @ در آدرس شناسه حساب سرویس ایجاد شده استفاده می‌شود.

    در زیر نوع کلید ، توصیه می کنیم این مقدار را به عنوان JSON بگذارید. برای ایجاد یک کلید JSON به عنوان فایل متنی .json روی Create کلیک کنید. هنگامی که از شما خواسته شد، فایل را در رایانه خود دانلود کنید و یک گفتگوی ایجاد حساب سرویس نمایش داده می شود.

    در اینجا یک نمونه کلید JSON وجود دارد:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. فایل JSON خود را ایمن ذخیره کنید، زیرا حاوی کلید خصوصی شما است و این فایل تنها کپی آن کلید است. زمانی که کد شما با API تماس می گیرد، اعتبارنامه موجود در این فایل مورد نیاز است.

  4. با اطلاعات حساب سرویسی که ایجاد کرده اید، به ویژه آدرس ایمیل حساب سرویس، با DV360 تماس بگیرید. این بخشی از فرآیند لیست مجاز برای دسترسی به API است.

نشانه دسترسی

پس از اینکه حساب سرویس شما مجاز به برقراری تماس با API شد، می‌توانید با مثال‌های موجود در راهنماهای API ادامه دهید. برای دریافت دستی نشانه دسترسی، می توانید از ابزاری مانند oauth2l استفاده کنید. یا از یکی از کتابخانه های سرویس گیرنده خود برای احراز هویت برنامه نویسی استفاده کنید.