שנתחיל?

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 כדי ליצור פרויקט ב-Google API Console. אם כבר יש לכם חשבון, הכול מוכן. אפשר גם להשתמש בחשבון 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 לשימוש בתהליך ההתקנה של האפליקציה. למידע על יצירת פרטי כניסה לשימוש בתהליך של חשבון השירות, תוכלו לקרוא את המדריך Service Accounts.

1. יש לפעול לפי השלבים להגדרת פרויקט ב-Google API Console.

2. פותחים את הדף Credentials ב-API Console.

3. לוחצים על Create credentials > מזהה לקוח OAuth.

4. כשתוצג הבקשה, בוחרים את סוג האפליקציה הרלוונטי ביותר. קטעי הקוד של Java ו-Python שמוצעים במדריכים האלה מבוססים על אפליקציה למחשב, וקטעי הקוד של PHP מבוססים על אפליקציית אינטרנט.

5. מזינים את המידע הנדרש הנוסף.

   • אם זו הפעם הראשונה שאתם יוצרים מזהה לקוח, מלבד האפשרות לבחור את סוג האפליקציה, תוכלו להגדיר את מסך ההסכמה באמצעות לחיצה על הלחצן Configure consent screen (הגדרת מסך הסכמה). לא תוצג לכם בקשה להגדיר שוב את מסך ההסכמה אחרי שתעשו זאת בפעם הראשונה, אבל תוכלו לעדכן את המידע הזה בכל שלב.

6. לוחצים על יצירה.

בסיום, יוצגו לכם מזהה לקוח וסוד לקוח של OAuth 2.0, שאפשר להוריד בפורמט JSON ולשמור אותם לשימוש במועד מאוחר יותר.

הגדרת מסך ההסכמה של המשתמשים

כשמשתמשים ב-OAuth 2.0 לאימות, המשתמשים עוברים אימות אחרי שהם מסכימים לתנאים שמוצגים להם במסך ההסכמה של המשתמש.

כדי להגדיר את מסך ההסכמה של הפרויקט, יש לבצע את הפעולות הבאות:

1. פותחים את דף מסך ההסכמה ב-Google API Console. אם מתבקשים, בוחרים פרויקט קיים או יוצרים פרויקט חדש.
2. ממלאים את הטופס ולוחצים על שמירה.