Method: advertisers.audit

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

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

GET https://displayvideo.googleapis.com/v3/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)

विज्ञापन देने वाले के खाते में, चालू, रोके गए, और ड्राफ़्ट में मौजूद लाइन आइटम की संख्या. ये लाइन आइटम, विज्ञापन देने वाले हर व्यक्ति या कंपनी के लिए तय की गई 9999 लाइन आइटम की सीमा में गिने जाते हैं.
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,000,000 तक सीमित होती है. इनमें अलग-अलग टारगेटिंग विकल्प भी शामिल होते हैं.

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

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

string (int64 format)

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

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

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

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

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

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

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