סקירה כללית

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

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

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

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

  2. נכנסים לדף Google Cloud Console Enabled APIs. בוחרים את הפרויקט שיצרתם קודם.

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

    1. משתמשים בתיבת החיפוש כדי לחפש את Curation Partners API.
    2. בדף התוצאות, לוחצים על Curation Partners API (שותפי אוספים API).
    3. לוחצים על הפעלה.

    יש בעיה ידועה שמונעת את האפשרות למצוא את Curation Partners API באמצעות תיבת החיפוש במסוף Google Cloud. לחלופין, אפשר להשתמש ב-Google Cloud CLI כדי להפעיל את ה-API. אחרי שמתקינים את ה-CLI של gcloud, אפשר להפעיל את Curation Partners API באמצעות הפקודה הבאה:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  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 שאפשר לגשת אליהם באמצעות הטוקן הזה. ב-Curation Partners API, ההיקף הזה הוא https://www.googleapis.com/auth/curation-partners.

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

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

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

השלבים הבאים