Method: advertisers.negativeKeywordLists.negativeKeywords.list

यह नेगेटिव कीवर्ड की सूची में मौजूद नेगेटिव कीवर्ड दिखाता है.

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

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. DV360 पर विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिससे पैरंट नेगेटिव कीवर्ड सूची जुड़ी है.

negativeKeywordListId

string (int64 format)

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

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

orderBy

string

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

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

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

filter

string

इसकी मदद से, नेगेटिव कीवर्ड फ़ील्ड के हिसाब से फ़िल्टर किया जा सकता है.

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

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

इन फ़ील्ड के लिए यह सुविधा उपलब्ध है:

  • keywordValue

उदाहरण:

  • ऐसे सभी नेगेटिव कीवर्ड जिनके कीवर्ड वैल्यू में "google" शामिल है: keywordValue : "google"

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

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

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

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

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

NegativeKeywordService.ListNegativeKeywords के लिए जवाब का मैसेज.

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

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

object (NegativeKeyword)

नेगेटिव कीवर्ड की सूची.

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

nextPageToken

string

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

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

अनुमति के स्कोप

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

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

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