از 8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به صفحه لغو اعتبار ما مراجعه کنید.
با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
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، باید موارد زیر را انجام دهید:
شما باید یک حساب Google داشته باشید. برای ایجاد پروژه در Google API Console به یک حساب Google نیاز دارید. اگر قبلاً یک حساب کاربری دارید، پس همه چیز آماده است. همچنین ممکن است یک حساب Google جداگانه برای اهداف آزمایشی بخواهید.
شما باید به Display & Video 360 دسترسی داشته باشید. برای کار با API باید به محصول Display & Video 360 دسترسی داشته باشید. اگر سازمان شما قبلاً قرارداد Display & Video 360 دارد، مطمئن شوید که نمایه کاربری با مجوزهای مناسب برای حساب(های) Google شما ایجاد شده است. اگر نه، برای اطلاعات بیشتر با تیم فروش ما تماس بگیرید .
باید Display & Video 360 را امتحان کنید. این مستندات API فرض می‌کند که شما از Display & Video 360 استفاده کرده‌اید، و با مفاهیم برنامه‌نویسی وب و قالب‌های داده‌های وب آشنا هستید. اگر از Display & Video 360 استفاده نکرده‌اید، قبل از شروع کدنویسی ، رابط کاربری وب را امتحان کنید.
می توانید یک پروژه جدید ایجاد کنید یا از یک پروژه موجود استفاده کنید.
یک پروژه جدید ایجاد کنید
برای ایجاد پروژه و فعال کردن خودکار Display & Video 360 API، مراحل موجود در Google API Console را دنبال کنید.
از یک پروژه موجود استفاده کنید
در اینجا نحوه فعال کردن دستی Display & Video 360 API برای یک پروژه موجود آورده شده است.
برای فعال کردن یک API برای پروژه خود، موارد زیر را انجام دهید:
کتابخانه API را در Google API Console باز کنید . در صورت درخواست، یک پروژه را انتخاب کنید یا یک پروژه جدید ایجاد کنید. کتابخانه API همه API های موجود را فهرست می کند که بر اساس خانواده محصول و محبوبیت گروه بندی شده اند.
اگر API مورد نظر برای فعال کردن در لیست قابل مشاهده نیست، از جستجو برای پیدا کردن آن استفاده کنید.
API را که می خواهید فعال کنید انتخاب کنید، سپس روی دکمه Enable کلیک کنید.
در صورت درخواست، صورتحساب را فعال کنید.
اگر از شما خواسته شد، شرایط سرویس API را بپذیرید.
اعتبارنامه تولید کنید
همه درخواست‌هایی که به Display & Video 360 API می‌کنید باید مجاز باشند. برای یک نمای کلی از مجوز، درباره نحوه تأیید و شناسایی برنامه خود در Google بخوانید.
دستورالعمل های زیر شما را در فرآیند ایجاد شناسه مشتری OAuth 2.0 برای استفاده با جریان برنامه نصب شده راهنمایی می کند. برای دستورالعمل‌های مربوط به ایجاد اعتبار برای استفاده با جریان حساب سرویس، به راهنمای حساب‌های خدمات مراجعه کنید.
زمانی که از شما خواسته شد، کاربردی ترین نوع برنامه را انتخاب کنید. تکه کدهای جاوا و پایتون ارائه شده در این راهنماها یک برنامه دسکتاپ را فرض می کنند، در حالی که تکه کدهای PHP یک برنامه وب را فرض می کنند.
اطلاعات اضافی مورد نیاز را وارد کنید.
اگر اولین بار است که یک شناسه مشتری ایجاد می‌کنید، علاوه بر اینکه می‌توانید نوع برنامه خود را انتخاب کنید، می‌توانید با کلیک کردن روی دکمه پیکربندی صفحه رضایت، صفحه رضایت خود را پیکربندی کنید. پس از اولین بار انجام این کار، درخواستی برای پیکربندی مجدد صفحه رضایت خود دریافت نخواهید کرد، اگرچه این اطلاعات را می توان در هر زمانی به روز کرد.
روی ایجاد کلیک کنید.
پس از اتمام، یک شناسه مشتری OAuth 2.0 و راز سرویس گیرنده به شما نمایش داده می شود که می توانید آنها را با فرمت JSON دانلود کرده و برای استفاده بعدی ذخیره کنید.
صفحه رضایت کاربر را پیکربندی کنید
وقتی از OAuth 2.0 برای احراز هویت استفاده می کنید، کاربران شما پس از موافقت با شرایط ارائه شده به آنها در صفحه رضایت کاربر، احراز هویت می شوند.
برای تنظیم صفحه رضایت پروژه خود، موارد زیر را انجام دهید:
صفحه Consent Screen را در Google API Console باز کنید. در صورت درخواست، یک پروژه را انتخاب کنید یا یک پروژه جدید ایجاد کنید.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Display & Video 360 API allows programmatic access to automate complex workflows within the Display & Video 360 platform, including tasks like creative management, line item targeting, and structured data file generation.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a Google Account, access to Display & Video 360, and familiarize yourself with the platform's web UI.\u003c/p\u003e\n"],["\u003cp\u003eYou need to create or select a Google API Console project and enable the Display & Video 360 API to start using it.\u003c/p\u003e\n"],["\u003cp\u003eGenerate OAuth 2.0 credentials for authorization, following the guide for either installed application or service account flow depending on your needs.\u003c/p\u003e\n"],["\u003cp\u003eConfigure a user consent screen for your project within the Google API Console to handle user authentication when using OAuth 2.0.\u003c/p\u003e\n"]]],["The Display & Video 360 API automates tasks like uploading creatives, managing line items and targeting, and generating Structured Data Files. To begin, users need a Google Account and Display & Video 360 access, alongside experience with the platform. They must create or select a project in the Google API Console and enable the API. Credentials, specifically an OAuth 2.0 client ID, must be generated, and the user consent screen must be configured to enable application authorization.\n"],null,["The Display \\& Video 360 API is the programmatic interface for the Display \\& Video 360\nplatform. You can use the Display \\& Video 360 API to automate complex\nDisplay \\& Video 360 workflows. Here are some examples of tasks you can do with the\nDisplay \\& Video 360 API:\n\n- [Upload and build\n creatives.](/display-video/api/guides/creating-creatives/overview)\n- [Manage line items and their\n targeting.](/display-video/api/guides/managing-line-items/overview)\n- [Generate and download Structured Data\n Files.](/display-video/api/guides/downloading-sdfs/create)\n\nThis guide describes how to get started with the Display \\& Video 360 API.\n\nPrerequisites\n\nBefore using the Display \\& Video 360 API, you must do the following:\n\n1. **You must have a Google Account.** You need a\n [Google Account](//www.google.com/accounts/NewAccount) in order to [create a project](#create_project)\n in the Google API Console. If you already have an\n account, then you're all set. You may also want a separate Google Account for\n testing purposes.\n\n2. **You must have access to Display \\& Video 360.** You need access to the\n Display \\& Video 360 product in order to work with the API. If your\n organization already has a Display \\& Video 360 contract, ensure a\n [user profile](//support.google.com/displayvideo/answer/2723011) with appropriate permissions has been\n created for your Google Account(s). If not,\n [contact our sales team](//marketingplatform.google.com/about/display-video-360/) for more information.\n\n3. **You should try out Display \\& Video 360.** This API documentation assumes\n that you've used Display \\& Video 360, and that you're familiar with web\n programming concepts and web data formats. If you haven't used\n Display \\& Video 360, then try out the [web UI](https://displayvideo.google.com/) before\n starting to code.\n\nChoose a project\n\nYou need to [create\nor select a project in the Google API Console and enable the API](https://console.cloud.google.com/start/api?id=displayvideo.googleapis.com&credential=client_key).\n\nYou can create a new project, or use an existing one.\n\nCreate a new project\n\nFollow the steps in the [Google API Console](https://console.cloud.google.com/start/api?id=displayvideo.googleapis.com&credential=client_key)\nto create a project and enable the Display \\& Video 360 API automatically.\n\nUse an existing project\n\nHere's how to manually activate the Display \\& Video 360 API for an existing project.\n\nTo enable an API for your project, do the following:\n\n1. [Open the API Library](https://console.cloud.google.com/apis/library) in the Google API Console. If prompted, select a project or create a new one. The API Library lists all available APIs, grouped by product family and popularity.\n2. If the API you want to enable isn't visible in the list, use search to find it.\n3. Select the API you want to enable, then click the **Enable** button.\n4. If prompted, enable billing.\n5. If prompted, accept the API's Terms of Service.\n\nGenerate credentials\n\nAll requests you make to the Display \\& Video 360 API must be authorized. For a brief\noverview of authorization, read about how to [authorize and identify your\napplication to Google](/display-video/api/guides/how-tos/authorizing).\n\nThe following instructions guide you through the process of creating an OAuth\n2.0 client ID to use with the [installed application\nflow](/identity/protocols/OAuth2InstalledApp). For instructions on generating credentials for use\nwith the service account flow, refer to the [Service Accounts](/display-video/api/guides/how-tos/service-account)\nguide.\n\n1. Follow the steps to [configure a Google API Console project](#create_project).\n\n\n2. Open the [Credentials page](https://console.cloud.google.com/apis/credentials) in the API Console.\n3. Click **Create credentials** \\\u003e **OAuth client ID**.\n\n4. Select the most applicable application type when prompted. The Java and\n Python code snippets offered in these guides assume a **Desktop app** , while\n the PHP code snippets assume a **Web application**.\n\n5. Enter any additional required information.\n\n - If this is your first time creating a client ID, besides being able to select your application type, you can configure your consent screen by clicking the **Configure consent screen** button. You won't get a prompt to configure your consent screen again after you do it the first time, although this information can be updated at any time.\n6. Click **Create**.\n\nWhen done, you'll be presented with an OAuth 2.0 client ID and client\nsecret, which you can download in JSON format and save for later use.\n\nConfigure the user consent screen\n\nWhen you use OAuth 2.0 for authentication, your users are authenticated after\nthey agree to terms presented to them on a user consent screen.\n\n\nTo set up your project's consent screen, do the following:\n\n1. Open the [Consent Screen page](https://console.cloud.google.com/apis/credentials/consent) in the Google API Console. If prompted, select a project or create a new one.\n2. Fill out the form and click **Save**."]]
