Curation Partners API

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

שירות: curationpartners.googleapis.com

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

מסמך Discovery

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

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

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה. לשירות הזה יש את נקודת הקצה הבאה, וכל כתובות ה-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
הצגת רשימה של אובייקטים מסוג Report.
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
מציג רשימה של כל החשבונות ב-Media Planner שלמבצע הקריאה החוזרת (caller) יש גישה אליהם.
search GET /v1/mediaPlanners:search
חיפוש חשבונות של Media Planner שתואמים למזהה המושב הנתון ב-DSP.