Method: advertisers.audit

מבצעת ביקורת על מפרסם. הפונקציה מחזירה את מספר הישויות שנעשה בהן שימוש לפי סוג המשאב, במפרסם שצוין. ישויות בשימוש נספרות במגבלת המשאבים שלהן. מידע נוסף זמין בכתובת https://support.google.com/displayvideo/answer/6071450.

בקשת HTTP

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}:audit

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
advertiserId

string (int64 format)

חובה. מזהה המפרסם שרוצים לבדוק.

פרמטרים של שאילתה

פרמטרים
readMask

string (FieldMask format)

אופציונלי. השדות הספציפיים שיוחזרו. אם לא צוינה מסכה, כל השדות בפרוטוקול התגובה ימולאו. הערכים החוקיים כוללים:

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

זוהי רשימה מופרדת בפסיקים של שמות שדות שמוגדרים במלואם. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת תגובה ל-AdvertiserService.AuditAdvertiser.

אם הפעולה בוצעה בהצלחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
שדות
usedLineItemsCount

string (int64 format)

מספר הפריטים הפעילים, המושהים והטיוטות של הפריטים אצל המפרסם הזה. הפריטים האלה נספרים במגבלה של 9,999 פריטים לכל מפרסם.
usedInsertionOrdersCount

string (int64 format)

מספר ההזמנות הפעילות, המושהות והזמנות הטיוטה של המפרסם הזה. הזמנות הקמפיין האלה נכללות במגבלה של 9,999 הזמנות קמפיין לכל מפרסם.
usedCampaignsCount

string (int64 format)

מספר הקמפיינים הפעילים והמושהים של המפרסם הזה. הקמפיינים האלה נכללים במגבלה של 9,999 קמפיינים לכל מפרסם.
channelsCount

string (int64 format)

מספר הערוצים שנוצרו אצל המפרסם הזה. הערוצים האלה נכללים במגבלה של 1,000 ערוצים לכל מפרסם.
negativelyTargetedChannelsCount

string (int64 format)

מספר הערוצים שהוגדרו לטירגוט שלילי אצל המפרסם הזה. הערוצים האלה נכללים במגבלה של 5 ערוצים בטירגוט שלילי לכל מפרסם.
negativeKeywordListsCount

string (int64 format)

מספר הרשימות של מילות המפתח השליליות שנוצרו בחשבון המפרסם הזה. הרשימות האלה נכללות במגבלה של 20 רשימות של מילות מפתח שליליות לכל מפרסם.
adGroupCriteriaCount

string (int64 format)

מספר אפשרויות הטירגוט הנפרדות מסוגי הטירגוט הבאים שמוקצות לפריט אצל המפרסם הזה. אפשרויות הטירגוט האלה נכללות במגבלה של 4,500,000 אפשרויות טירגוט של קבוצות של מודעות לכל מפרסם.

סוגי הטירגוט שעומדים בדרישות:

  • ערוצים, כתובות URL, אפליקציות ואוספים
  • מאפיינים דמוגרפיים
  • קהלים ש-Google מגדירה, כולל קהלים עם תחום עניין משותף, קהלים בהתאמה אישית עם תחום עניין משותף וקהלים עם כוונת רכישה
  • מקור מלאי
  • מילת מפתח
  • Mobile app category
  • רשימות משתמשים
  • מיקוד וידאו
  • ניראות
campaignCriteriaCount

string (int64 format)

מספר אפשרויות הטירגוט הנפרדות מסוגי הטירגוט הבאים שמוקצות לפריט אצל המפרסם הזה. אפשרויות הטירגוט הנפרדות האלה נכללות במגבלה של 900,000 אפשרויות טירגוט ברמת הקמפיין לכל מפרסם.

סוגי הטירגוט שעומדים בדרישות:

  • מיקום
  • דפדפן
  • מהירות החיבור
  • יום ושעה
  • המכשיר (Device) ומערכת ההפעלה (operating system)
  • תווית תוכן דיגיטלי
  • קטגוריות רגישות
  • סביבה
  • מיקום גיאוגרפי, כולל רשתות עסקים וקרבה
  • ISP
  • שפה
  • אימות של צד שלישי

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/display-video

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.