Method: advertisers.audit

विज्ञापन देने वाले की ऑडिटिंग करना. विज्ञापन देने वाले व्यक्ति या कंपनी के लिए, हर संसाधन टाइप के हिसाब से इस्तेमाल की गई इकाइयों की संख्या दिखाता है. इस्तेमाल की गई इकाइयों को उनकी संसाधन सीमा में गिना जाता है. https://support.google.com/displayvideo/answer/6071450 देखें.

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

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}:audit

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

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

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

पैरामीटर
readMask

string (FieldMask format)

ज़रूरी नहीं. नतीजे में दिखाए जाने वाले फ़ील्ड. अगर कोई मास्क तय नहीं किया गया है, तो रिस्पॉन्स प्रोटो के सभी फ़ील्ड भर दिए जाएंगे. मान्य मान हैं:

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट है. उदाहरण: "user.displayName,photo".

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

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

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

AdvertiserService.AuditAdvertiser के लिए जवाब वाला मैसेज.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
फ़ील्ड
usedLineItemsCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के खाते में मौजूद, चालू, रोके गए, और ड्राफ़्ट लाइन आइटम की संख्या. इन लाइन आइटम को, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए तय की गई 9,999 लाइन आइटम की सीमा में गिना जाता है.
usedInsertionOrdersCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के चालू, रोके गए, और ड्राफ़्ट किए गए इंसर्शन ऑर्डर की संख्या. ये इंसर्शन ऑर्डर, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए तय की गई 9,999 इंसर्शन ऑर्डर की सीमा में गिने जाते हैं.
usedCampaignsCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के खाते में मौजूद, चालू और रोके गए कैंपेन की संख्या. ये कैंपेन, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए तय की गई 9,999 कैंपेन की सीमा में गिने जाते हैं.
channelsCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के बनाए गए चैनलों की संख्या. इन चैनलों को, विज्ञापन देने वाले व्यक्ति या कंपनी के लिए तय की गई 1,000 चैनलों की सीमा में गिना जाता है.
negativelyTargetedChannelsCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के तहत बनाए गए, नेगेटिव टारगेटिंग वाले चैनलों की संख्या. नेगेटिव तौर पर टारगेट किए गए ये चैनल, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए, नेगेटिव तौर पर टारगेट किए गए पांच चैनलों की सीमा में गिने जाते हैं.
negativeKeywordListsCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के खाते में बनाई गई नेगेटिव कीवर्ड सूचियों की संख्या. ये नेगेटिव कीवर्ड सूचियां, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए, 20 नेगेटिव कीवर्ड सूचियों की सीमा में गिनी जाती हैं.
adGroupCriteriaCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के किसी लाइन आइटम को असाइन किए गए, टारगेटिंग के इन टाइप में से अलग-अलग टारगेटिंग विकल्पों की संख्या. टारगेटिंग के ये अलग-अलग विकल्प, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए, विज्ञापन ग्रुप के 45,00,000 टारगेटिंग विकल्पों की सीमा में गिने जाते हैं.

ज़रूरी शर्तें पूरी करने वाली टारगेटिंग के टाइप:

  • चैनल, यूआरएल, ऐप्लिकेशन, और कलेक्शन
  • डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह)
  • Google की ऑडियंस. इनमें अफ़िनिटी ऑडियंस, कस्टम अफ़िनिटी ऑडियंस, और मिलते-जुलते प्रॉडक्ट या सेवा में दिलचस्पी रखने वाले ग्राहक शामिल हैं
  • इन्वेंट्री स्रोत
  • कीवर्ड
  • मोबाइल ऐप्लिकेशन की श्रेणी
  • उपयोगकर्ता सूचियां
  • वीडियो लक्ष्यीकरण
  • विज्ञापन दिखने से जुड़े आंकड़े
campaignCriteriaCount

string (int64 format)

विज्ञापन देने वाले इस व्यक्ति या कंपनी के किसी लाइन आइटम को असाइन किए गए, टारगेटिंग के अलग-अलग विकल्पों की संख्या. ये विकल्प, टारगेटिंग के इन टाइप से जुड़े होते हैं. विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए, कैंपेन टारगेटिंग के 9,00,000 विकल्पों की सीमा में, टारगेटिंग के ये अलग-अलग विकल्प भी शामिल होते हैं.

ज़रूरी शर्तें पूरी करने वाली टारगेटिंग के टाइप:

  • स्थिति
  • ब्राउज़र
  • कनेक्शन स्पीड
  • Day and time
  • डिवाइस और ऑपरेटिंग सिस्टम
  • डिजिटल सामग्री लेबल
  • संवेदनशील कैटगरी
  • परिवेश
  • भौगोलिक जानकारी, जिसमें कई आउटलेट वाले कारोबारी ग्रुप और नज़दीकी कारोबार शामिल हैं
  • आईएसपी (इमेज सिग्नल प्रोसेसर)
  • भाषा
  • तीसरे पक्ष की मदद से पुष्टि करना

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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