Method: advertisers.locationLists.list

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

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

GET https://displayvideo.googleapis.com/v1/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

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

string

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

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

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

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

  • locationType

उदाहरण:

  • इलाके के हिसाब से सभी जगहों की सूची: locationType="TARGETING_LOCATION_TYPE_REGIONAL"
  • आस-पास के सभी जगहों की सूची: locationType="TARGETING_LOCATION_TYPE_PROXIMITY"

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

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

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

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

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

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

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

object (LocationList)

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

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

string

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

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

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

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

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

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