Method: sellers.adUnits.list

यह विज्ञापन यूनिट की सूची बनाता है.

  • उदाहरण के लिए, GET /v1/sellers/seller111/adUnits
  • सफल होने पर अगला पेज फिर से पाने के लिए विज्ञापन यूनिट की सूची और टोकन दिखाता है.
  • अगर उपयोगकर्ता के पास सेलर आईडी या सेलर आईडी का ऐक्सेस नहीं है, तो गड़बड़ी का कोड PERMISSION_DENIED दिखाता है.
  • अगर सेलर अमान्य पेज साइज़ या पेज टोकन देते हैं, तो गड़बड़ी का कोड INVALID_ARGUMENT दिखाता है.

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

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह विक्रेता जिसके पास विज्ञापन यूनिट के इस कलेक्शन का मालिकाना हक है. फ़ॉर्मैट: सेलर/{seller}

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

पैरामीटर
pageSize

integer

लौटाए जाने वाले सामान की ज़्यादा से ज़्यादा संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. विज्ञापन यूनिट की ज़्यादा से ज़्यादा संख्या 1,000 हो सकती है; अगर वैल्यू 1000 से ज़्यादा है, तो वह 1000 में बदल जाएगी. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 1,000 विज्ञापन यूनिट दिखाई जाएंगी.
pageToken

string

अगर पिछले सूची अनुरोध की मदद से, NextPageToken वैल्यू कोई मिलती है, तो वह मिलती है.
filter

string

सूची फ़िल्टर. फ़िलहाल, बाहरी आईडी और स्थिति को फ़िल्टर करने के लिए, इस सिंटैक्स का इस्तेमाल किया जा सकता है: "externalId = [EXTERNAL_ID]" और "state = [स्टेट]". लॉजिकल ऑपरेटर AND और OR का इस्तेमाल फ़िल्टर चेन के लिए किया जा सकता है. हटाई गई विज्ञापन यूनिट को दिखाने के लिए AD_UNIT_स्टेट_DELETED का इस्तेमाल नहीं किया जा सकता. इसके बजाय, show Deleted का इस्तेमाल करें.
orderBy

string

नतीजों को क्रम से लगाने के लिए, स्ट्रिंग के हिसाब से क्रम का इस्तेमाल किया जाता है. फ़िलहाल, updateTime से ऑर्डर करने की सुविधा उपलब्ध है. "updateTime" की जानकारी दें अपडेट के समय के हिसाब से बढ़ते क्रम या "updateTime का ब्यौरा" के हिसाब से क्रम में लगाए गए नतीजे पाने के लिए घटते क्रम में लगाएं.
showDeleted

boolean

क्या सॉफ़्ट तौर पर मिटाई गई विज्ञापन यूनिट दिखानी हैं.

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

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

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

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

InventoryService.ListAdUnits के लिए जवाब का मैसेज.

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

object (AdUnit)

विज्ञापन यूनिट की सूची.
nextPageToken

string

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

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

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

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