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)

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