Method: advertisers.audit

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

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

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

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

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

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. ऑडिट करने के लिए, विज्ञापन देने वाले का आईडी.

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

पैरामीटर
readMask

string (FieldMask format)

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

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

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

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

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

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

AdvertiserService.ऑडिटAdvertiser के लिए रिस्पॉन्स मैसेज.

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

सभी ज़रूरी टारगेटिंग के टाइप:

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

अनुमति के दायरे

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

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

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