Method: advertisers.audit

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

בקשת HTTP

GET https://displayvideo.googleapis.com/v3/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.