סקירה כללית

אתם יכולים ליצור ולנהל פלחי נתונים באמצעות Authorized Buyers Marketplace API, שחושף משאב curators.dataSegments. זהו REST API עם ספריות לקוח שנוצרו שאפשר להשתמש בהן לשילוב.

מגדירים אימות

ממשקי Google API משתמשים בפרוטוקול OAuth 2.0 לאימות ולהרשאה. כך מגדירים חשבון שירות כדי לגשת ל-Marketplace API.

  1. אם עדיין לא עשיתם זאת, צריך ליצור פרויקט ב-Google Cloud שבו מאוחסנים פרטי הכניסה שמשמשים לגישה ל-API.
  2. נכנסים לדף APIs Enabled במסוף Google Cloud. בוחרים את הפרויקט שיצרתם קודם.

  3. תוצג רשימה של ממשקי API ושירותים מופעלים. כדי לגשת ל-Marketplace API, צריך להפעיל אותו. אם Marketplace API לא מופעל, לוחצים על +Enable APIs and services ומבצעים את ההוראות הבאות:

    1. תועברו לדף עם תיבת חיפוש. מחפשים את Authorized Buyers Marketplace API.
    2. בדף התוצאות, בוחרים באפשרות Authorized Buyers Marketplace API.
    3. לוחצים על Enable.
  4. בתפריט הניווט, בוחרים באפשרות Credentials (פרטי כניסה).
  5. לוחצים על +Create credentials ובתפריט הנפתח שמופיע בוחרים באפשרות Service account.
  6. מזינים שם לחשבון השירות. מזהה חשבון השירות נוצר אוטומטית בזמן היצירה. חשוב לשים לב לערך הזה כי תצטרכו אותו בהמשך, בשלב 14. אפשר גם להוסיף תיאור. לוחצים על יצירה והמשך.
  7. אפשר להגדיר הרשאות לחשבון השירות ואז ללחוץ על המשך.
  8. אפשר גם להגדיר משתמשים או קבוצות שיכולים לבצע פעולות בתור חשבון השירות, ואז ללחוץ על סיום.
  9. חשבון השירות החדש מופיע בקטע חשבונות שירות. מוצאים את מזהה חשבון השירות שיצרתם ולוחצים עליו.
  10. לוחצים על הכרטיסייה Keys.
  11. בתפריט הנפתח Add key, בוחרים באפשרות Create new key.
  12. בוחרים באפשרות JSON בתור Key type ולוחצים על Create.
  13. מורידים את המפתח לספריית העבודה. מידע נוסף על אחסון מאובטח של המפתח זמין במאמר ניהול מפתחות של חשבונות שירות. המפתח משמש את האפליקציה שלכם כדי לבצע קריאות ל-API.
  14. משתפים את מזהה חשבון השירות עם מנהל החשבון הטכני כדי לקשר את חשבון השירות לחשבון שלכם.

היקפי API

כשמבצעים את תהליך OAuth 2.0 כדי לקבל אסימון גישה שמשמש לביצוע קריאה ל-API, צריך לציין את ממשקי ה-API שאפשר לגשת אליהם באמצעות האסימון הזה. ב-Authorized Buyers Marketplace API, היקף ההרשאות הזה הוא https://www.googleapis.com/auth/authorized-buyers-marketplace.

איך מזהים פלחי נתונים ב-API לעומת ב'ניהול נתונים בזמן אמת'

ב-Marketplace API, פלחים של נתונים מזוהים באמצעות שם של משאב ספציפי ל-API, כמו:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

כשמזהים את פלחי הנתונים שרלוונטיים להצגת מודעה בבחירת מיקום בזמן אמת, צריך לציין את הערך של מזהה המשאב DATA_SEGMENT_ID ולא את המשאב המלא name שמשמש את ה-API.

השלבים הבאים