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 को भेजा जाने वाला मैसेज.

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

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,00,000 विज्ञापन ग्रुप टारगेटिंग विकल्पों की सीमा में, अलग-अलग टारगेटिंग के इन विकल्पों की गिनती की जाती है.

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

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

string (int64 format)

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

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

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

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

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

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

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