Method: advertisers.manualTriggers.list

यह ऐसे मैन्युअल ट्रिगर की सूची बनाता है जिन्हें मौजूदा उपयोगकर्ता, विज्ञापन देने वाले किसी दिए गए आईडी के लिए ऐक्सेस कर सकते हैं.

यह क्रम orderBy पैरामीटर से तय होता है.

एक advertiserId होना ज़रूरी है.

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

GET https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}/manualTriggers

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

पाथ के पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

मैन्युअल ट्रिगर प्रॉपर्टी के हिसाब से फ़िल्टर करने की सुविधा देती है.

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

  • फ़िल्टर एक्सप्रेशन में एक या ज़्यादा पाबंदियां होती हैं.
  • AND या OR लॉजिकल ऑपरेटर की मदद से, पाबंदियां जोड़ी जा सकती हैं. पाबंदियों का क्रम, साफ़ तौर पर AND का इस्तेमाल करता है.
  • पाबंदी {field} {operator} {value} के रूप में होती है.
  • ऑपरेटर EQUALS (=) होना चाहिए.
  • इस्तेमाल किए जा सकने वाले फ़ील्ड:
    • displayName
    • state के उदाहरण:
  • विज्ञापन देने वाली कंपनी के सभी ऐक्टिव मैन्युअल ट्रिगर: state="ACTIVE"

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

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

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

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

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

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

object (ManualTrigger)

मैन्युअल ट्रिगर की सूची.

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

nextPageToken

string

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

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

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

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

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