Method: advertisers.audit

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
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)

מספר הזמנות הקמפיין ACTIVE, מושהית ו-DRAFT מתחת למפרסם הזה. הזמנות הקמפיין האלה נכללות במגבלה של 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)

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

סוגי טירגוט מתאימים:

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

string (int64 format)

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

סוגי טירגוט מתאימים:

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

היקפי הרשאות

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

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.