Method: advertisers.youtubeAdGroups.bulkListAdGroupAssignedTargetingOptions

רשימות שהוקצו להן אפשרויות מיקוד עבור קבוצות מודעות מרובות של YouTube בכל סוגי המיקוד.

אפשרויות טירגוט שהועברו בירושה לא נכללות.

בקשת HTTP

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

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

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

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שאליו שייכים הפריטים.

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

פרמטרים
youtubeAdGroupIds[]

string (int64 format)

חובה. המזהים של קבוצות מודעות YouTube שעבורן מוקצות אפשרויות מיקוד.
pageSize

integer

אפשרות. גודל הדף המבוקש. הגודל חייב להיות מספר שלם בין 1 ל-5000. אם לא צוין אחרת, ברירת המחדל היא 5000. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken

string

אפשרות. אסימון שמאפשר ללקוח לאחזר את דף התוצאות הבא. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method youtubeAdGroups.bulkListAdGroupAssignedTargetingOptions. אם לא מציינים שום אפשרות, יוחזר דף התוצאות הראשון.
orderBy

string

אפשרות. שדה שלפיו ממיינים את הרשימה. הערכים הקבילים הם:

  • youtubeAdGroupId (ברירת מחדל)
  • assignedTargetingOption.targetingType

סדר המיון שמוגדר כברירת מחדל הוא בסדר עולה. כדי לציין סדר יורד של שדה, צריך להוסיף סיומת 'description' לשם השדה. דוגמה: targetingType desc
filter

string

אפשרות. מאפשר סינון לפי שדות של אפשרויות מיקוד שהוקצו.

תחביר נתמך:

  • ביטויי סינון מורכבים מהגבלה אחת או יותר.
  • אפשר לשלב את ההגבלות באמצעות האופרטור הלוגי OR.
  • המונח של הגבלה הוא {field} {operator} {value}.
  • יש להשתמש באופרטור EQUALS (=) בכל השדות.

שדות נתמכים:

  • targetingType

דוגמאות:

  • AssignedTargetingOption משאבים מסוג טירגוט TARGETING_TYPE_YOUTUBE_VIDEO או TARGETING_TYPE_YOUTUBE_CHANNEL: targetingType="TARGETING_TYPE_YOUTUBE_VIDEO" OR targetingType="TARGETING_TYPE_YOUTUBE_CHANNEL"

האורך של השדה הזה לא יעלה על 500 תווים.

למידע נוסף, אפשר לעיין במדריך שלנו בנושא סינון בקשות LIST.

גוף הבקשה

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

גוף התשובה

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

ייצוג JSON 
{
  "youtubeAdGroupAssignedTargetingOptions": [
    {
      object (YoutubeAdGroupAssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
שדות
youtubeAdGroupAssignedTargetingOptions[]

object (YoutubeAdGroupAssignedTargetingOption)

רשימת האובייקטים של wrapper, שכל אחד מהם מספק אפשרות מיקוד שהוקצתה ואת קבוצת המודעות של YouTube שאליה הוא מוקצה.

אם הרשימה ריקה, היא לא תופיע.
nextPageToken

string

אסימון שמזהה את דף התוצאות הבא. יש לציין את הערך הזה בתור pageToken בקריאה נוספת אל youtubeAdGroups.bulkListAdGroupAssignedTargetingOptions כדי לאחזר את דף התוצאות הבא. האסימון הזה חסר אם אין יותר המרות מסוג youtubeAdGroupAssignedTargetingOptions.

היקפי הרשאות

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

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

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

YoutubeAdGroupAssignedTargetingOption

אובייקט wrapper שמשייך משאב AssignedTargetingOption וקבוצת מודעות YouTube שאליה הוא מוקצה.

ייצוג JSON 
{
  "youtubeAdGroupId": string,
  "assignedTargetingOption": {
    object (AssignedTargetingOption)
  }
}
שדות
youtubeAdGroupId

string (int64 format)

המזהה של קבוצת המודעות ב-YouTube שאליה מוקצית אפשרות הטירגוט.
assignedTargetingOption

object (AssignedTargetingOption)

המשאב שהוקצה לאפשרות הטירגוט.