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

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

filter

string

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

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

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

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

  • targetingType
  • inheritance

उदाहरण:

  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST या TARGETING_TYPE_CHANNEL टारगेटिंग टाइप के AssignedTargetingOption संसाधन: targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="TARGETING_TYPE_CHANNEL"
  • NOT_INHERITED या INHERITED_FROM_PARTNER के इनहेरिटेंस स्टेटस वाले AssignedTargetingOption संसाधन: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

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

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

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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 की खास जानकारी देखें.

LineItemAssignedTargetingOption

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

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

string (int64 format)

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

assignedTargetingOption

object (AssignedTargetingOption)

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