Method: advertisers.audit

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

בקשת HTTP

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

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

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

פרמטרים
advertiserId

string (int64 format)

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

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

פרמטרים
readMask

string (FieldMask format)

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

  • 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.