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

ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. דוגמה: 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)

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