Method: advertisers.lineItems.bulkListAssignedTargetingOptions

टारगेटिंग के अलग-अलग टाइप के लिए, कई लाइन आइटम को टारगेट करने के विकल्प असाइन की गई सूचियां.

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

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

यह यूआरएल, 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

यह एक टोकन है, जो नतीजों के अगले पेज की पहचान करता है. नतीजों का अगला पेज फ़ेच करने के लिए, इस वैल्यू को lineItems.bulkListAssignedTargetingOptions को किए जाने वाले अगले कॉल में pageToken के तौर पर तय किया जाना चाहिए. अगर लौटाने के लिए और lineItemAssignedTargetingOptions नहीं हैं, तो यह टोकन मौजूद नहीं होगा.

अनुमति पाने के लिंक

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

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

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

LineItemAssignedTargetingOption

रैपर ऑब्जेक्ट, जो assignedTargetingOption संसाधन और उसे असाइन किए गए लाइन आइटम को जोड़ता है.

JSON के काेड में दिखाना
{
  "lineItemId": string,
  "assignedTargetingOption": {
    object (AssignedTargetingOption)
  }
}
फ़ील्ड
lineItemId

string (int64 format)

यह उस लाइन आइटम का आईडी होता है जिसे असाइन किया गया टारगेटिंग विकल्प असाइन किया गया है.

assignedTargetingOption

object (AssignedTargetingOption)

टारगेटिंग के लिए असाइन किया गया विकल्प.