Curation Partners API

‫Curation partners API הוא HTTP API שזמין חיצונית לאוספים, ומאפשר להם לנהל באופן פרוגרמטי את פלחי הנתונים ואת חבילות התוכן שאצורות על ידם, שמשמשות סוכנויות פרסום.

שירות: curationpartners.googleapis.com

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.

מסמך Discovery

Discovery Document הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי API ל-REST. היא משמשת לבניית ספריות לקוח, תוספים ל-IDE וכלים אחרים שמתקשרים עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך Discovery הבא:

נקודת קצה של שירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה (endpoint) והיא: כל כתובות ה-URI שמופיעות בהמשך הן יחסיות לנקודת הקצה הזו של השירות:

  • https://curationpartners.googleapis.com

משאב REST: ‏ v1.curators.curatedPackages

Methods
activate POST /v1/{name=curators/*/curatedPackages/*}:activate
מפעיל חבילה קיימת שאוצרה.
create POST /v1/{parent=curators/*}/curatedPackages
יוצר חבילה חדשה שאוצרה.
deactivate POST /v1/{name=curators/*/curatedPackages/*}:deactivate
השבתה של חבילה קיימת שאוצרה.
get ‫GET /v1/{name=curators/*/curatedPackages/*}
מקבל חבילה שנבחרה בקפידה בהינתן שם המשאב שלה.
list GET /v1/{parent=curators/*}/curatedPackages
מציג רשימה של חבילות שנמצאות בבעלות של האוצר שצוין.
patch PATCH /v1/{curatedPackage.name=curators/*/curatedPackages/*}
מעדכן חבילה קיימת.

משאב REST: ‏ v1.curators.dataSegments

Methods
activate POST /v1/{name=curators/*/dataSegments/*}:activate
מפעיל פלח נתונים.
create POST /v1/{parent=curators/*}/dataSegments
יוצר פלח נתונים בבעלות האוסף שצוין.
deactivate POST /v1/{name=curators/*/dataSegments/*}:deactivate
משבית פלח נתונים.
get GET /v1/{name=curators/*/dataSegments/*}
מקבל פלח נתונים לפי השם שלו.
list GET /v1/{parent=curators/*}/dataSegments
מפרטים את פלחי הנתונים שבבעלות האוסף.
patch PATCH /v1/{dataSegment.name=curators/*/dataSegments/*}
מעדכן פלח נתונים.

משאב REST: ‏ v1.curators.reports

Methods
create POST /v1/{parent=curators/*}/reports
יוצרת אובייקט Report.
delete DELETE /v1/{name=curators/*/reports/*}
מוחק אובייקט Report.
get GET /v1/{name=curators/*/reports/*}
מאחזר אובייקט Report.
list GET /v1/{parent=curators/*}/reports
Lists Report objects.
patch PATCH /v1/{report.name=curators/*/reports/*}
מעדכנת אובייקט Report.
run POST /v1/{name=curators/*/reports/*}:run
מפעילה את ההרצה של דוח קיים באופן אסינכרוני.

משאב REST: ‏ v1.curators.reports.operations

Methods
get ‫GET /v1/{name=curators/*/reports/*/operations/*}
אחזור המצב העדכני של פעולה ממושכת.

משאב REST: ‏ v1.curators.reports.results

Methods
fetchRows GET /v1/{name=curators/*/reports/*/results/*}:fetchRows
מחזירה את שורות התוצאות מדוח שהושלם.

משאב REST: ‏ v1.mediaPlanners

Methods
list ‫GET /v1/mediaPlanners
רשימה של כל החשבונות בכלי לתכנון מדיה שלמבצע הקריאה החוזרת יש גישה אליהם.