شروع کنید

Display & Video 360 API رابط برنامه‌ای برای پلتفرم Display & Video 360 است. می‌توانید از Display & Video 360 API برای خودکارسازی گردش‌های کاری پیچیده Display & Video 360 استفاده کنید. در اینجا چند نمونه از کارهایی است که می توانید با Display & Video 360 API انجام دهید:

این راهنما نحوه شروع کار با Display & Video 360 API را شرح می دهد.

پیش نیازها

قبل از استفاده از Display & Video 360 API، باید موارد زیر را انجام دهید:

  1. شما باید یک حساب Google داشته باشید. برای ایجاد پروژه در Google API Console به یک حساب Google نیاز دارید. اگر قبلاً یک حساب کاربری دارید، پس همه چیز آماده است. همچنین ممکن است یک حساب Google جداگانه برای اهداف آزمایشی بخواهید.

  2. شما باید به Display & Video 360 دسترسی داشته باشید. برای کار با API باید به محصول Display & Video 360 دسترسی داشته باشید. اگر سازمان شما قبلاً قرارداد Display & Video 360 دارد، مطمئن شوید که نمایه کاربری با مجوزهای مناسب برای حساب(های) Google شما ایجاد شده است. اگر نه، برای اطلاعات بیشتر با تیم فروش ما تماس بگیرید .

  3. باید Display & Video 360 را امتحان کنید. این مستندات API فرض می‌کند که شما از Display & Video 360 استفاده کرده‌اید، و با مفاهیم برنامه‌نویسی وب و قالب‌های داده‌های وب آشنا هستید. اگر از Display & Video 360 استفاده نکرده‌اید، قبل از شروع کدنویسی، رابط کاربری وب را امتحان کنید.

یک پروژه را انتخاب کنید

باید یک پروژه را در Google API Console ایجاد یا انتخاب کنید و API را فعال کنید .

می توانید یک پروژه جدید ایجاد کنید یا از یک پروژه موجود استفاده کنید.

یک پروژه جدید ایجاد کنید

برای ایجاد پروژه و فعال کردن خودکار Display & Video 360 API، مراحل موجود در Google API Console را دنبال کنید.

از یک پروژه موجود استفاده کنید

در اینجا نحوه فعال کردن دستی Display & Video 360 API برای یک پروژه موجود آورده شده است.

برای فعال کردن یک API برای پروژه خود، موارد زیر را انجام دهید:

  1. کتابخانه API را در Google API Console باز کنید . در صورت درخواست، یک پروژه را انتخاب کنید یا یک پروژه جدید ایجاد کنید. کتابخانه API همه API های موجود را فهرست می کند که بر اساس خانواده محصول و محبوبیت گروه بندی شده اند.
  2. اگر API مورد نظر برای فعال کردن در لیست قابل مشاهده نیست، از جستجو برای پیدا کردن آن استفاده کنید.
  3. API را که می خواهید فعال کنید انتخاب کنید، سپس روی دکمه Enable کلیک کنید.
  4. در صورت درخواست، صورتحساب را فعال کنید.
  5. اگر از شما خواسته شد، شرایط سرویس API را بپذیرید.

اعتبارنامه تولید کنید

همه درخواست‌هایی که به Display & Video 360 API می‌کنید باید مجاز باشند. برای یک نمای کلی از مجوز، درباره نحوه تأیید و شناسایی برنامه خود در Google بخوانید.

دستورالعمل های زیر شما را در فرآیند ایجاد شناسه مشتری OAuth 2.0 برای استفاده با جریان برنامه نصب شده راهنمایی می کند. برای دستورالعمل‌های مربوط به ایجاد اعتبار برای استفاده با جریان حساب سرویس، به راهنمای حساب‌های خدمات مراجعه کنید.

  1. مراحل را برای پیکربندی پروژه Google API Console دنبال کنید.

  2. صفحه Credentials را در کنسول API باز کنید.
  3. روی ایجاد اعتبار > شناسه مشتری OAuth کلیک کنید.

  4. زمانی که از شما خواسته شد، کاربردی ترین نوع برنامه را انتخاب کنید. تکه کدهای جاوا و پایتون ارائه شده در این راهنماها یک برنامه دسکتاپ را فرض می کنند، در حالی که تکه کدهای PHP یک برنامه وب را فرض می کنند.

  5. اطلاعات اضافی مورد نیاز را وارد کنید.

    • اگر اولین بار است که یک شناسه مشتری ایجاد می‌کنید، علاوه بر اینکه می‌توانید نوع برنامه خود را انتخاب کنید، می‌توانید با کلیک کردن روی دکمه پیکربندی صفحه رضایت، صفحه رضایت خود را پیکربندی کنید. پس از اولین بار انجام این کار، درخواستی برای پیکربندی مجدد صفحه رضایت خود دریافت نخواهید کرد، اگرچه این اطلاعات را می توان در هر زمانی به روز کرد.
  6. روی ایجاد کلیک کنید.

پس از اتمام، یک شناسه مشتری OAuth 2.0 و راز سرویس گیرنده به شما نمایش داده می شود که می توانید آنها را با فرمت JSON دانلود کرده و برای استفاده بعدی ذخیره کنید.

وقتی از OAuth 2.0 برای احراز هویت استفاده می کنید، کاربران شما پس از موافقت با شرایط ارائه شده به آنها در صفحه رضایت کاربر، احراز هویت می شوند.

برای تنظیم صفحه رضایت پروژه خود، موارد زیر را انجام دهید:

  1. صفحه Consent Screen را در Google API Console باز کنید. در صورت درخواست، یک پروژه را انتخاب کنید یا یک پروژه جدید ایجاد کنید.
  2. فرم را پر کنید و روی ذخیره کلیک کنید.