Method: advertisers.lineItems.targetingTypes.assignedTargetingOptions.list

किसी लाइन आइटम को असाइन किए गए टारगेटिंग विकल्प की सूची बनाता है.

एचटीटीपी अनुरोध

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. लाइन आइटम, विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी.
lineItemId

string (int64 format)

ज़रूरी है. उस लाइन आइटम का आईडी जिसके लिए असाइन किए गए टारगेटिंग विकल्पों की सूची बनानी है.
targetingType

enum (TargetingType)

ज़रूरी है. सूची में असाइन किए गए टारगेटिंग विकल्पों के टाइप की पहचान करता है.

टारगेटिंग के ये टाइप इस्तेमाल किए जा सकते हैं:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_AUDIO_CONTENT_TYPE
  • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_CARRIER_AND_ISP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_CONTENT_DURATION
  • TARGETING_TYPE_CONTENT_GENRE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_STREAM_TYPE
  • TARGETING_TYPE_DAY_AND_TIME
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_INVENTORY_SOURCE
  • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_ON_SCREEN_POSITION
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_SUB_EXCHANGE
  • TARGETING_TYPE_THIRD_PARTY_VERIFIER
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_USER_REWARDED_CONTENT
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY
  • TARGETING_TYPE_YOUTUBE_CHANNEL (सिर्फ़ LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE लाइन आइटम के लिए)
  • TARGETING_TYPE_YOUTUBE_VIDEO (सिर्फ़ LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE लाइन आइटम के लिए)

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

पेज का वह साइज़ जिसके लिए अनुरोध किया गया है. वैल्यू, 1 और 5000 के बीच होनी चाहिए. अगर कोई जानकारी नहीं दी गई है, तो वह डिफ़ॉल्ट रूप से 100 पर सेट हो जाएगी. अमान्य वैल्यू दिए जाने पर गड़बड़ी कोड INVALID_ARGUMENT दिखाता है.
pageToken

string

एक टोकन, जो सर्वर को दिखाए जाने वाले नतीजों के पेज की पहचान करता है. आम तौर पर, यह nextPageToken की वैल्यू है. यह वैल्यू, assignedTargetingOptions.list को पिछले कॉल किए गए तरीके से मिलती है. अगर इसके बारे में तय नहीं किया गया है, तो नतीजों का पहला पेज दिखाया जाएगा.
orderBy

string

वह फ़ील्ड जिसके आधार पर सूची को क्रम से लगाया जाना है. ये वैल्यू स्वीकार की जा सकती हैं:

  • assignedTargetingOptionId (डिफ़ॉल्ट)

क्रम से लगाने का डिफ़ॉल्ट क्रम बढ़ते क्रम में है. किसी फ़ील्ड के घटते क्रम में तय करने के लिए, फ़ील्ड के नाम में "ब्यौरा" सफ़िक्स जोड़ना चाहिए. उदाहरण: assignedTargetingOptionId desc.
filter

string

असाइन किए गए टारगेटिंग विकल्प फ़ील्ड के आधार पर फ़िल्टर करने की अनुमति देता है.

इस्तेमाल किया जा सकने वाला सिंटैक्स:

  • फ़िल्टर एक्सप्रेशन में एक या ज़्यादा पाबंदियां होती हैं.
  • लॉजिकल ऑपरेटर OR की मदद से, पाबंदियों को जोड़ा जा सकता है.
  • पाबंदी {field} {operator} {value} के रूप में होती है.
  • सभी फ़ील्ड में EQUALS (=) ऑपरेटर का इस्तेमाल करना ज़रूरी है.

इस्तेमाल किए जा सकने वाले फ़ील्ड:

  • assignedTargetingOptionId
  • inheritance

उदाहरण:

  • 1 या 2 आईडी वाले AssignedTargetingOption रिसॉर्स: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"
  • NOT_INHERITED या INHERITED_FROM_PARTNER के इनहेरिटेंस स्टेटस वाले AssignedTargetingOption संसाधन: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए.

ज़्यादा जानकारी के लिए, हमारी फ़िल्टर LIST अनुरोध गाइड देखें.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

assignedTargetingOptions.list के लिए जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "assignedTargetingOptions": [
    {
      object (AssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
assignedTargetingOptions[]

object (AssignedTargetingOption)

असाइन किए गए टारगेटिंग विकल्पों की सूची.

खाली होने पर, यह सूची नहीं दिखेगी.
nextPageToken

string

एक टोकन, जो नतीजों के अगले पेज की पहचान करता है. नतीजों का अगला पेज फ़ेच करने के लिए, इस वैल्यू को अगले ListLineItemAssignedTargetingOptionsRequest में pageToken के तौर पर सबमिट करना होगा. अगर कोई assignedTargetingOptions नहीं है, तो यह टोकन मौजूद नहीं रहेगा.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.