Method: advertisers.lineItems.bulkListAssignedTargetingOptions

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

בקשת HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:bulkListAssignedTargetingOptions

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

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

פרמטרים
advertiserId

string (int64 format)

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

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

פרמטרים
lineItemIds[]

string (int64 format)

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

integer

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

string

אסימון שמאפשר ללקוח לאחזר את דף התוצאות הבא. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה lineItems.bulkListAssignedTargetingOptions. אם לא יצוין, יוצג דף התוצאות הראשון.
orderBy

string

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

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

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

string

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

תחביר נתמך:

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

שדות נתמכים:

  • targetingType
  • inheritance

דוגמאות:

  • משאבים מסוג AssignedTargetingOption עם טירגוט מסוג TARGETING_TYPE_PROXIMITY_LOCATION_LIST או TARGETING_TYPE_CHANNEL: targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="TARGETING_TYPE_CHANNEL"
  • משאבי AssignedTargetingOption עם סטטוס ירושה של NOT_INHERITED או INHERITED_FROM_PARTNER: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

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

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

גוף הבקשה

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

גוף התשובה

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

ייצוג ב-JSON 
{
  "lineItemAssignedTargetingOptions": [
    {
      object (LineItemAssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
שדות
lineItemAssignedTargetingOptions[]

object (LineItemAssignedTargetingOption)

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

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

string

אסימון שמזהה את דף התוצאות הבא. צריך לציין את הערך הזה כ-pageToken בקריאה הבאה ל-lineItems.bulkListAssignedTargetingOptions כדי לאחזר את דף התוצאות הבא. האסימון הזה לא יופיע אם אין יותר lineItemAssignedTargetingOptions להחזיר.

היקפי הרשאה

נדרשת הרשאת OAuth ברמה הבאה:

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

מידע נוסף זמין בOAuth 2.0 Overview.

LineItemAssignedTargetingOption

אובייקט wrapper שמשויך משאב assignedTargetingOption לפריט החשבון שאליו הוא מוקצה.

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

string (int64 format)

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

object (AssignedTargetingOption)

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