راه اندازی Auth

نصب Api فروشنده DV360

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

فرآیند لیست مجاز با تماس با تیم API فروشنده DV360 انجام می شود.

مراحل ورود:

  1. با رفتن به https://console.cloud.google.com/ یک حساب Google ثبت نام کنید
    • این حساب برای مدیریت نشانه‌های دسترسی مشتری تولیدی شما استفاده می‌شود. از حساب شخصی جیمیل خود استفاده نکنید.
    • حساب نمی تواند یک گروه Google باشد.
    • اگر از پروژه Google Cloud موجود استفاده می کنید: حساب باید مدیر پروژه باشد.
  2. با اطلاعات حسابی که ثبت نام کرده اید با Google DV360 تماس بگیرید تا به لیست مجاز اضافه شود.
  3. صبر کنید تا حساب شما به لیست مجاز اضافه شود.
  4. اختیاری و غیرمسدود: برای دسترسی به محدوده (doubleclickbidmanager) یک درخواست بررسی تأیید OAuth برای برنامه خود ارسال کنید.
  5. به https://console.cloud.google.com/ بروید. به API & Services -> Library -> Private بروید. باید بتوانید API فروشنده DV360 را که به عنوان یکی از APIهای موجود در دسترس شما قرار دارد، مشاهده کنید.
  6. فعال کردن API فروشنده DV360
  7. به مسیر Credentials -> Create a Credential -> Service Account Key بروید. دستورالعمل ها را در اینجا دنبال کنید: https://developers.google.com/identity/protocols/OAuth2ServiceAccount

    راه اندازی یک حساب خدمات:

    توجه: اگر می‌خواهید از یک حساب سرویس موجود، مانند DV360 Reporting API استفاده مجدد کنید، به ما اطلاع دهید.

    احراز هویت و مجوز Google Cloud API (که معمولاً با هم به عنوان "aut" گروه بندی می شوند) معمولاً با استفاده از یک حساب سرویس انجام می شود. یک حساب سرویس به کد شما اجازه می‌دهد تا اطلاعات کاربری برنامه را مستقیماً به Cloud API ارسال کند. یک حساب سرویس، مانند یک حساب کاربری، با یک آدرس ایمیل نشان داده می شود. با این حال، برخلاف حساب کاربری، یک حساب سرویس فقط به یک برنامه تعلق دارد و فقط برای دسترسی به API که برای آن ایجاد شده است، می توان از آن استفاده کرد. به عنوان مثال، نحوه ایجاد اعتبار حساب سرویس را با استفاده از کنسول Google Cloud Platform نشان خواهیم داد.

    با استفاده از Google Cloud Console

    از صفحه Google Cloud Console API Manager→Credentials ، "Create credentials→ Service key account" را انتخاب کنید.

    alt_text

    در مرحله بعد، «حساب سرویس جدید» را از منوی کشویی «حساب سرویس» انتخاب کنید.

    alt_text

    یک «نام» برای این حساب سرویس تایپ کنید. این نام به عنوان نام پیش‌فرض برای "شناسه حساب سرویس" شما (در سمت چپ "@" در آدرس شناسه حساب سرویس ایجاد شده) استفاده می‌شود، اما در صورت تمایل می‌توانید نام شناسه حساب سرویس را تغییر دهید. این نام ها می توانند دلخواه باشند. فقط مهم است که آنها را به خاطر بسپارید. در بخش «نوع کلید»، توصیه می‌کنیم این مقدار را به‌عنوان «JSON» بگذارید. روی «ایجاد» کلیک کنید، کنسول GCP یک کلید JSON (به عنوان یک فایل متنی .json ) ایجاد می‌کند، از شما می‌خواهد فایل را در رایانه خود بارگیری کنید و یک کادر محاوره‌ای ایجاد شده حساب سرویس را نمایش می‌دهد.

    alt_text

    کلید JSON تولید شده مشابه کلید 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"
    }

    این فایل JSON را ایمن ذخیره کنید، زیرا حاوی کلید خصوصی شماست (و این فایل تنها کپی آن کلید است). زمانی که می‌خواهید اعتبارنامه‌ها را به Google Cloud Platform API ارسال کنید، باید به این فایل کلید حساب سرویس در کد خود مراجعه کنید.

  8. با اطلاعات حساب سرویسی که ایجاد کردید با DV360 تماس بگیرید. به طور خاص ما به ایمیل این حساب سرویس نیاز داریم. این یکی دیگر از فرآیندهای لیست مجاز برای مجوز است.
  9. هنگامی که حساب سرویس شما مجاز به تماس با API شد، می توانید برای اسناد API به https://developers.google.com/display-video/seller مراجعه کنید. برای دریافت رمز تأیید به صورت دستی، دستورالعمل‌ها را اینجا ببینید: https://github.com/google/oauth2l . (باید نسخه JSON کلید حساب سرویس خود را قبلا دانلود کرده باشید). همچنین دستورالعمل‌های دقیقی درباره نحوه دریافت Oauth Token به صورت برنامه‌ریزی شده در اینجا وجود دارد: https://cloud.google.com/docs/authentication/production .

مهم: دامنه OAuth باید 'doubleclickbidmanager' باشد