Method: advertisers.audit

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

בקשת HTTP

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

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

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

פרמטרים
advertiserId

string (int64 format)

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

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

פרמטרים
readMask

string (FieldMask format)

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

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

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

גוף הבקשה

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

גוף התשובה

הודעת תגובה ל-AdvertisingService.Audit Advertiser.

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

ייצוג 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)

מספר הזמנות הקמפיין פעילות, מושהות ו-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
  • שפה
  • אימות של צד שלישי

היקפי ההרשאות

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

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

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