اعتبارًا من 8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Display & Video 360 API هي الواجهة الآلية لمنصّة "مساحة العرض والفيديو 360". يمكنك استخدام Display & Video 360 API لأتمتة سير العمل المعقدة في "مساحة العرض والفيديو 360". في ما يلي بعض الأمثلة على المهام التي يمكنك تنفيذها باستخدام واجهة برمجة التطبيقات Display & Video 360 API:
يوضّح هذا الدليل كيفية بدء استخدام Display & Video 360 API.
المتطلبات الأساسية
قبل استخدام واجهة برمجة التطبيقات Display & Video 360 API، عليك إجراء ما يلي:
يجب أن يكون لديك حساب على Google. تحتاج إلى حساب Google من أجل إنشاء مشروع في وحدة تحكّم واجهة برمجة التطبيقات Google API Console. إذا كان لديك حساب، يمكنك استخدامه. قد تحتاج أيضًا إلى حساب Google منفصل لأغراض testing.
يجب أن يكون لديك إذن الوصول إلى "مساحة العرض والفيديو 360". يجب أن يكون لديك إذن الوصول إلى منتج "مساحة العرض والفيديو 360" لاستخدام واجهة برمجة التطبيقات. إذا كان مؤسّستك لديها عقد حالي على "مساحة العرض والفيديو 360"، تأكّد من أنّه تم إنشاء ملف شخصي للمستخدِم يتضمّن الأذونات المناسبة لحساباتك على Google. إذا لم يكن الأمر كذلك، يُرجى التواصل مع فريق المبيعات للحصول على مزيد من المعلومات.
ننصحك بتجربة "مساحة العرض والفيديو 360". تفترض مستندات واجهة برمجة التطبيقات هذه أنّك استخدمت "مساحة العرض والفيديو 360" وأنّك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب. إذا لم يسبق لك استخدام "مساحة العرض والفيديو 360 "، جرِّب واجهة مستخدم الويب قبل البدء في الترميز.
افتح "مكتبة واجهات برمجة التطبيقات" في "وحدة تحكّم واجهة Google API". اختَر مشروعًا أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك. تعرض "مكتبة واجهات برمجة التطبيقات" كلّ واجهات برمجة التطبيقات المتاحة، مجمّعة حسب عائلة المنتجات ومدى رواج استخدامها.
إذا لم تظهر واجهة برمجة التطبيقات التي تريد تفعيلها في القائمة، استخدِم ميزة البحث للعثور عليها.
اختَر واجهة برمجة التطبيقات التي تريد تفعيلها، ثم انقر على الزر تفعيل.
فعِّل ميزة الفوترة إذا طُلب منك ذلك.
اقبل بنود خدمة واجهة برمجة التطبيقات إذا طُلب منك ذلك.
إنشاء بيانات الاعتماد
يجب أن تكون جميع الطلبات التي تقدّمها إلى واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" مصرّحًا بها. للحصول على نظرة عامةمختصرة على التفويض، يُرجى الاطّلاع على كيفية تفويض Google بالوصول إلى تطبيقك وتحديد هويته.
سترشدك التعليمات التالية خلال عملية إنشاء معرّف مستخدم OAuth 2.0 لاستخدامه مع مسار التطبيق المثبّت. للحصول على تعليمات حول إنشاء بيانات الاعتماد لاستخدامها مع مسار حساب الخدمة، يُرجى الرجوع إلى دليل حسابات الخدمة.
اختَر نوع التطبيق الأكثر ملاءمةً عندما يُطلب منك ذلك. تستند مقتطفات الرموز البرمجية لـ Java و Python المقدَّمة في هذه الأدلة إلى تطبيق كمبيوتر مكتبي، في حين تستند مقتطفات الرموز البرمجية لـ PHP إلى تطبيق ويب.
أدخِل أي معلومات إضافية مطلوبة.
إذا كانت هذه هي المرة الأولى التي تنشئ فيها معرّف عملاء، بالإضافة إلى التمكّن من اختيار نوع تطبيقك، يمكنك ضبط شاشة الموافقة من خلال النقر على الزر ضبط شاشة الموافقة. لن تظهر لك رسالة تطلب منك ضبط شاشة طلب الموافقة مرة أخرى بعد ضبطها في المرة الأولى، ولكن يمكن تعديل هذه المعلومات في أي وقت.
انقر على إنشاء.
عند الانتهاء، سيظهر لك معرّف عميل وملف تعريف العميل لبروتوكول OAuth 2.0، ويمكنك تنزيلهما بتنسيق JSON وحفظهما لاستخدامهما لاحقًا.
ضبط شاشة موافقة المستخدم
عند استخدام بروتوكول OAuth 2.0 للمصادقة، تتم مصادقة المستخدمين بعد أن يوافقوا على الأحكام التي يتم عرضها لهم على شاشة طلب موافقة المستخدم.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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**."]]
