Curation partners API הוא ממשק HTTP API שזמין באופן חיצוני, ומאפשר לאוצרים לנהל באופן פרוגרמטי את פלחי הנתונים ואת החבילות שנאספו ומשמשות סוכנויות פרסום.
- משאב REST: v1.curators.curatedPackages
- משאב REST: v1.curators.dataSegments
- משאב REST: v1.curators.reports
- משאב REST: v1.curators.reports.operations
- משאב REST: v1.curators.reports.results
- משאב REST: v1.mediaPlanners
שירות: 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. |