Method: advertisers.locationLists.list

यह डायलॉग बॉक्स, विज्ञापन देने वाले किसी दिए गए आईडी के आधार पर जगहों की सूचियां बनाता है.

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

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/locationLists

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. DV360 ऐडवर्टाइज़र का आईडी, जिससे फ़ेच की गई जगहों की सूचियां जुड़ी हैं.

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

पैरामीटर
pageSize

integer

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

pageToken

string

टोकन, जो नतीजों के उस पेज की पहचान करता है जिसे सर्वर को दिखाना चाहिए.

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

orderBy

string

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

  • locationListId (डिफ़ॉल्ट)
  • displayName

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

filter

string

जगह की सूची वाले फ़ील्ड के हिसाब से फ़िल्टर करने की अनुमति देता है.

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

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

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

  • locationType

उदाहरण:

  • सभी क्षेत्रीय जगहों की सूची: locationType="TARGETING_LOCATION_TYPE_REGIONAL"
  • आस-पास की जगहों की सूची: locationType="TARGETING_LOCATION_TYPE_PROXIMITY"

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

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

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

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

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

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

JSON के काेड में दिखाना
{
  "locationLists": [
    {
      object (LocationList)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
locationLists[]

object (LocationList)

जगहों की सूची.

अगर यह सूची खाली होगी, तो यह नहीं होगी.

nextPageToken

string

नतीजों का अगला पेज वापस पाने के लिए टोकन.

नतीजों का अगला पेज वापस पाने के लिए, अगली कॉल locationLists.list तरीके में इस वैल्यू को pageToken फ़ील्ड में पास करें.

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

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

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

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