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.ऑडिट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 की खास जानकारी देखें.