החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
מתחילים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
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, כדאי לנסות את ממשק המשתמש באינטרנט לפני שתתחילו לתכנת.
בוחרים פרויקט
צריך ליצור או לבחור פרויקט ב-Google API Console ולהפעיל את ה-API.
אפשר ליצור פרויקט חדש או להשתמש בפרויקט קיים.
יצירת פרויקט חדש
פועלים לפי השלבים ב- Google API Console כדי ליצור פרויקט ולהפעיל את Display & Video 360 API באופן אוטומטי.
שימוש בפרויקט קיים
כך מפעילים באופן ידני את Display & Video 360 API בפרויקט קיים.
כדי להפעיל ממשק API בפרויקט:
- פותחים את API Library במסוף Google API. אם מופיעה בקשה, בוחרים פרויקט או יוצרים פרויקט חדש. בספריית ה-API מפורטים כל ממשקי ה-API הזמינים, שמקובצים לפי משפחת מוצרים ופופולריות.
- אם ה-API שרוצים להפעיל לא מופיע ברשימה, מחפשים אותו.
- בוחרים את ה-API שרוצים להפעיל ולוחצים על הלחצן Enable.
- אם תופיע בקשה, מפעילים את החיוב.
- אם מופיעה בקשה, מאשרים את התנאים וההגבלות של ה-API.
יצירת פרטי כניסה
כל הבקשות ששולחים ל-Display & Video 360 API צריכות לקבל הרשאה. איך מאשרים ומזהים את האפליקציה ל-Google
בהוראות הבאות מוסבר איך יוצרים מזהה לקוח ב-OAuth 2.0 לשימוש בתהליך של אפליקציה מותקנת. להוראות ליצירת פרטי כניסה לשימוש בתהליך של חשבון השירות, אפשר לעיין במדריך חשבונות שירות.
פועלים לפי השלבים להגדרת פרויקט ב-Google API Console.
- פותחים את דף פרטי הכניסה במסוף ה-API.
לוחצים על Create credentials (יצירת פרטי כניסה) > OAuth client ID (מזהה לקוח OAuth).
כשמופיעה בקשה, בוחרים את סוג האפליקציה הרלוונטי ביותר. קטעי הקוד של Java ו-Python שמופיעים במדריכים האלה מיועדים לאפליקציה למחשב, ואילו קטעי הקוד של PHP מיועדים לאפליקציית אינטרנט.
מזינים את כל המידע הנדרש.
- אם זו הפעם הראשונה שאתם יוצרים מזהה לקוח, בנוסף לאפשרות לבחור את סוג האפליקציה, תוכלו להגדיר את מסך ההסכמה בלחיצה על הלחצן Configure consent screen. אחרי שתגדירו את מסך ההסכמה בפעם הראשונה, לא תופיע בקשה להגדיר אותו שוב. עם זאת, תוכלו לעדכן את המידע הזה בכל שלב.
לוחצים על יצירה.
בסיום, יוצגו לכם מזהה לקוח וסודות לקוח של OAuth 2.0, שתוכלו להוריד בפורמט JSON ולשמור לשימוש מאוחר יותר.
כשמשתמשים ב-OAuth 2.0 לאימות, המשתמשים מאומתים אחרי שהם מסכימים לתנאים שמוצגים להם במסך ההסכמה של המשתמש.
כדי להגדיר את מסך ההסכמה של הפרויקט:
- פותחים את הדף Consent Screen במסוף Google API.
אם מתבקשים, בוחרים פרויקט או יוצרים פרויקט חדש.
- ממלאים את הטופס ולוחצים על שמירה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\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**."]]
