Method: targetingTypes.targetingOptions.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בתיבת הדו-שיח הזו מפורטים אפשרויות מיקוד של סוג נתון.
בקשת HTTP
GET https://displayvideo.googleapis.com/v1beta2/targetingTypes/{targetingType}/targetingOptions
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים |
targetingType |
enum (TargetingType )
חובה. סוג אפשרות הטירגוט שתוצג ברשימה. הערכים הקבילים הם:
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_VIEWABILITY
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_OMID
|
פרמטרים של שאילתה
פרמטרים |
advertiserId |
string (int64 format)
חובה. המפרסם, הבקשה הזו נשלחת בהקשר שלו.
|
pageSize |
integer
גודל הדף המבוקש. חייב להיות בין 1 ל-100 . אם לא צוין ערך, ברירת המחדל תהיה 100 . מחזירה קוד שגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
|
pageToken |
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method targetingOptions.list . אם לא מציינים שום אפשרות, יוחזר דף התוצאות הראשון.
|
orderBy |
string
שדה שלפיו תמיין את הרשימה. הערכים הקבילים הם:
targetingOptionId (ברירת מחדל)
סדר המיון המוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד לשדה מסוים, צריך להוסיף את הסיומת 'description' לשם השדה. דוגמה: targetingOptionId desc
|
filter |
string
מאפשר סינון לפי מאפיינים של אפשרויות טירגוט. תחביר נתמך:
- ביטויי סינון מורכבים מהגבלה אחת או יותר.
- אפשר לשלב את ההגבלות באמצעות
OR אופרטורים לוגיים.
- ההגבלה יכולה להיות
{field} {operator} {value} .
- האופרטור חייב להיות "=" (סימן שוויון).
- שדות נתמכים:
carrierAndIspDetails.type
geoRegionDetails.geoRegionType
targetingOptionId
דוגמאות:
- כל
GEO REGION אפשרויות הטירגוט ששייכות לסוג המשנה GEO_REGION_TYPE_COUNTRY או GEO_REGION_TYPE_STATE : geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR
geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE"
- כל
CARRIER AND ISP אפשרויות הטירגוט ששייכות לסוג המשנה CARRIER_AND_ISP_TYPE_CARRIER : carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" .
האורך המקסימלי של השדה הזה הוא 500 תווים.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
{
"targetingOptions": [
{
object (TargetingOption )
}
],
"nextPageToken": string
} |
שדות |
targetingOptions[] |
object (TargetingOption )
הרשימה של אפשרויות הטירגוט. אם הרשימה ריקה, היא לא תופיע.
|
nextPageToken |
string
אסימון לאחזור של דף התוצאות הבא. יש להעביר את הערך הזה בשדה pageToken בקריאה הבאה לשיטה targetingOptions.list כדי לאחזר את דף התוצאות הבא.
|
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-12-02 (שעון UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"חסרים לי מידע או פרטים"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"התוכן מורכב מדי או עם יותר מדי שלבים"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"התוכן לא עדכני"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"בעיה בתרגום"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"בעיה בדוגמאות/בקוד"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"סיבה אחרת"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"התוכן קל להבנה"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"התוכן עזר לי לפתור בעיה"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"סיבה אחרת"
}]