REST Resource: advertisers.creatives

संसाधन: क्रिएटिव

एक क्रिएटिव.

JSON के काेड में दिखाना 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. क्रिएटिव के संसाधन का नाम.
advertiserId

string (int64 format)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले उस व्यक्ति या कंपनी का यूनीक आईडी जिससे क्रिएटिव जुड़ा है.
creativeId

string (int64 format)

सिर्फ़ आउटपुट के लिए. क्रिएटिव का यूनीक आईडी. सिस्टम ने असाइन किया है.
cmPlacementId

string (int64 format)

सिर्फ़ आउटपुट के लिए. क्रिएटिव से जुड़े Campaign Manager 360 प्लेसमेंट का यूनीक आईडी. यह फ़ील्ड सिर्फ़ उन क्रिएटिव पर लागू होता है जिन्हें Campaign Manager से सिंक किया गया है.
displayName

string

ज़रूरी है. क्रिएटिव का डिसप्ले नेम.

यह UTF-8 कोड में होना चाहिए और इसका साइज़ ज़्यादा से ज़्यादा 240 बाइट होना चाहिए.
entityStatus

enum (EntityStatus)

ज़रूरी है. इससे यह कंट्रोल किया जाता है कि क्रिएटिव को दिखाया जा सकता है या नहीं.

ये वैल्यू स्वीकार की जाती हैं:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब क्रिएटिव को आखिरी बार अपडेट किया गया था. यह अपडेट, उपयोगकर्ता या सिस्टम (जैसे, क्रिएटिव की समीक्षा) ने किया हो. सिस्टम ने असाइन किया है.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. क्रिएटिव बनाए जाने का टाइमस्टैंप. सिस्टम ने असाइन किया है.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
creativeType

enum (CreativeType)

ज़रूरी है. इम्यूटेबल. क्रिएटिव का टाइप.
hostingSource

enum (HostingSource)

ज़रूरी है. इससे पता चलता है कि क्रिएटिव को कहां होस्ट किया गया है.
dynamic

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि क्रिएटिव डाइनैमिक है या नहीं.
dimensions

object (Dimensions)

ज़रूरी है. क्रिएटिव के प्राइमरी डाइमेंशन. यह सभी क्रिएटिव टाइप पर लागू होता है. जब creativeType इनमें से कोई एक हो, तो widthPixels और heightPixels की वैल्यू डिफ़ॉल्ट रूप से 0 पर सेट होती है:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

ज़रूरी नहीं. अतिरिक्त डाइमेंशन. यह तब लागू होता है, जब creativeType इनमें से कोई एक हो:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

अगर यह फ़ील्ड भरा गया है, तो widthPixels और heightPixels, दोनों को भरना ज़रूरी है. साथ ही, इनकी वैल्यू 0 या इससे ज़्यादा होनी चाहिए.
mediaDuration

string (Duration format)

सिर्फ़ आउटपुट के लिए. क्रिएटिव की मीडिया अवधि. यह तब लागू होता है, जब creativeType इनमें से कोई एक हो:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

सिर्फ़ आउटपुट के लिए. सिस्टम से जनरेट किए गए क्रिएटिव के एट्रिब्यूट की सूची.
reviewStatus

object (ReviewStatusInfo)

सिर्फ़ आउटपुट के लिए. क्रिएटिव की समीक्षा की प्रोसेस का मौजूदा स्टेटस.
assets[]

object (AssetAssociation)

ज़रूरी है. इस क्रिएटिव से जुड़ी ऐसेट.
exitEvents[]

object (ExitEvent)

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

  • Google Web Designer के टैप एरिया का इस्तेमाल करें.
  • "clickTag" नाम का JavaScript वैरिएबल तय करें.
  • रिच मीडिया फ़ॉर्मैट में एग्ज़िट ट्रैक करने के लिए, Enabler (Enabler.exit()) का इस्तेमाल करें.
timerEvents[]

object (TimerEvent)

ज़रूरी नहीं. रिच मीडिया क्रिएटिव के लिए टाइमर कस्टम इवेंट. टाइमर, उस समय को ट्रैक करते हैं जब कोई उपयोगकर्ता किसी रिच मीडिया क्रिएटिव के किसी खास हिस्से को देखता है और उससे इंटरैक्ट करता है. किसी क्रिएटिव में कई टाइमर इवेंट हो सकते हैं. हर इवेंट का समय अलग-अलग होता है. सिर्फ़ इमेज ऐसेट वाले क्रिएटिव के लिए, इसे खाली छोड़ दें या सेट न करें.
counterEvents[]

object (CounterEvent)

ज़रूरी नहीं. रिच मीडिया क्रिएटिव के लिए काउंटर इवेंट. काउंटर से यह ट्रैक किया जाता है कि किसी उपयोगकर्ता ने किसी रिच मीडिया क्रिएटिव के किसी हिस्से के साथ, तय किए गए तरीके से कितनी बार इंटरैक्ट किया. जैसे, माउस-ओवर, माउस-आउट, क्लिक, टैप, डेटा लोड करना, कीबोर्ड एंट्री वगैरह. क्रिएटिव में कैप्चर किए जा सकने वाले किसी भी इवेंट को काउंटर के तौर पर रिकॉर्ड किया जा सकता है. सिर्फ़ इमेज ऐसेट वाले क्रिएटिव के लिए, इसे खाली छोड़ दें या सेट न करें.
appendedTag

string

ज़रूरी नहीं. तीसरे पक्ष का एचटीएमएल ट्रैकिंग टैग, जिसे क्रिएटिव टैग में जोड़ा जाएगा.
integrationCode

string

ज़रूरी नहीं. इस क्रिएटिव को किसी बाहरी सिस्टम से लिंक करने के लिए इस्तेमाल की गई आईडी की जानकारी. यह UTF-8 कोड में बदला गया होना चाहिए. साथ ही, इसमें 10,000 से ज़्यादा वर्ण नहीं होने चाहिए.
notes

string

ज़रूरी नहीं. इस क्रिएटिव के लिए उपयोगकर्ता के नोट. यह UTF-8 कोड में बदला गया होना चाहिए. साथ ही, इसमें 20,000 से ज़्यादा वर्ण नहीं होने चाहिए.
iasCampaignMonitoring

boolean

ज़रूरी नहीं. इससे पता चलता है कि Integral Ad Science (IAS) कैंपेन की निगरानी की सुविधा चालू है या नहीं. क्रिएटिव के लिए इसे चालू करने के लिए, पक्का करें कि Advertiser.creative_config.ias_client_id को आपके IAS क्लाइंट आईडी पर सेट किया गया हो.
companionCreativeIds[]

string (int64 format)

ज़रूरी नहीं. किसी वीडियो क्रिएटिव के लिए, साथ दिखने वाले क्रिएटिव के आईडी.

पब्लिशर के वीडियो प्लेयर के आस-पास दिखाने के लिए, मौजूदा डिसप्ले क्रिएटिव (इमेज या HTML5 ऐसेट के साथ) असाइन किए जा सकते हैं. वीडियो चलने के दौरान, वीडियो प्लेयर के आस-पास कंपैनियन विज्ञापन दिखते हैं. साथ ही, वीडियो खत्म होने के बाद भी ये विज्ञापन दिखते रहते हैं.

additional dimensions वाले क्रिएटिव, कंपैनियन क्रिएटिव नहीं हो सकते.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन creativeType के लिए किया जा सकता है:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

ज़रूरी नहीं. उपयोगकर्ता के पास वीडियो क्रिएटिव को स्किप करने का विकल्प है या नहीं.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन creativeType के लिए किया जा सकता है:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

ज़रूरी नहीं. 'स्किप करें' बटन दिखने से पहले, वीडियो चलने की अवधि.

skippable के 'सही' होने पर, यह फ़ील्ड भरना ज़रूरी है.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन creativeType के लिए किया जा सकता है:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

ज़रूरी नहीं. वीडियो को कितनी देर तक चलाने के बाद, उसे व्यू के तौर पर गिना जाए.

skippable के 'सही है' पर सेट होने पर, यह फ़ील्ड भरना ज़रूरी है.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन creativeType के लिए किया जा सकता है:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

ज़रूरी नहीं. रजिस्ट्री से मिला क्रिएटिव का एक वैकल्पिक आइडेंटिफ़ायर, जो सभी प्लैटफ़ॉर्म पर यूनीक होता है.

यूनिवर्सल विज्ञापन आईडी, वीएएसटी 4.0 स्टैंडर्ड का हिस्सा है. क्रिएटिव बनाने के बाद, इसमें बदलाव किया जा सकता है.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन creativeType के लिए किया जा सकता है:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

ज़रूरी नहीं. तीसरे पक्ष के ट्रैकिंग यूआरएल, ताकि वीडियो क्रिएटिव के साथ हुए इंटरैक्शन को ट्रैक किया जा सके.

इस फ़ील्ड का इस्तेमाल, सिर्फ़ इन creativeType के लिए किया जा सकता है:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

सिर्फ़ आउटपुट के लिए. ऑडियो/वीडियो ट्रांसकोड.

Display & Video 360, मुख्य ऐसेट को कई वैकल्पिक वर्शन में ट्रांसकोड करता है. ये वर्शन, अलग-अलग फ़ाइल फ़ॉर्मैट का इस्तेमाल करते हैं या इनकी प्रॉपर्टी अलग-अलग होती हैं. जैसे, रिज़ॉल्यूशन, ऑडियो बिट रेट, और वीडियो बिट रेट. हर वर्शन को खास वीडियो प्लेयर या बैंडविड्थ के लिए डिज़ाइन किया जाता है.

इन ट्रांसकोड से, पब्लिशर के सिस्टम को आपके वीडियो पर हर इंप्रेशन के लिए, चुनने के ज़्यादा विकल्प मिलते हैं. साथ ही, यह पक्का होता है कि दर्शक के कनेक्शन और स्क्रीन के साइज़ के आधार पर सही फ़ाइल दिखे.

यह फ़ील्ड सिर्फ़ इन creativeType में काम करता है:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

ज़रूरी नहीं. ऐनलिटिक्स की सेवा देने वाली कंपनियों या विज्ञापन टेक्नोलॉजी की सेवा देने वाले तीसरे पक्ष के वेंडर के लिए ट्रैकिंग यूआरएल.

यूआरएल, https: से शुरू होने चाहिए. हालांकि, यह शर्त ऐसी इन्वेंट्री पर लागू नहीं होती जिसके लिए एसएसएल का पालन करना ज़रूरी नहीं है. अगर यूआरएल में मैक्रो का इस्तेमाल किया जा रहा है, तो सिर्फ़ उन मैक्रो का इस्तेमाल करें जो Display & Video 360 के साथ काम करते हैं.

सिर्फ़ स्टैंडर्ड यूआरएल इस्तेमाल करें. IMG या SCRIPT टैग इस्तेमाल न करें.

इस फ़ील्ड में सिर्फ़ इन creativeType में लिखा जा सकता है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

ज़रूरी नहीं. तीसरे पक्ष की पुष्टि करने वाली सेवा देने वाली कंपनियों (ComScore, DoubleVerify, IAS, Moat) से मिला JavaScript मेज़रमेंट यूआरएल. एचटीएमएल स्क्रिप्ट टैग का इस्तेमाल नहीं किया जा सकता.

इस फ़ील्ड में सिर्फ़ इन creativeType में लिखा जा सकता है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

ज़रूरी नहीं. क्रिएटिव से जुड़ा Campaign Manager 360 ट्रैकिंग विज्ञापन.

विज्ञापन देने वाला कोई व्यक्ति या कंपनी, Campaign Manager 360 और विज्ञापन देने वाले तीसरे पक्ष, दोनों का इस्तेमाल करके creativeType बनाती है, तो यह फ़ील्ड ज़रूरी नहीं होता:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

अन्य मामलों में, सिर्फ़ आउटपुट के लिए.
obaIcon

object (ObaIcon)

ज़रूरी नहीं. वीडियो क्रिएटिव के लिए ओबीए आइकॉन तय करता है.

यह फ़ील्ड सिर्फ़ इन creativeType में काम करता है:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

ज़रूरी नहीं. क्रिएटिव के लिए इस्तेमाल किया गया तीसरे पक्ष का ओरिजनल टैग.

यह ज़रूरी है और सिर्फ़ तीसरे पक्ष के टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के टैग वाले क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

ज़रूरी नहीं. इससे पता चलता है कि क्रिएटिव के लिए, एमआरएआईडी (मोबाइल रिच मीडिया विज्ञापन इंटरफ़ेस डेफ़िनिशन सिस्टम) ज़रूरी है.

अगर क्रिएटिव, इंटरैक्टिविटी के लिए मोबाइल जेस्चर पर निर्भर करता है, तो इसे सेट करें. जैसे, स्वाइप करना या टैप करना.

यह ज़रूरी नहीं है और सिर्फ़ तीसरे पक्ष के टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के टैग वाले क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

ज़रूरी नहीं. इससे पता चलता है कि क्रिएटिव को सही तरीके से रेंडर करने के लिए, HTML5 का इस्तेमाल किया गया है.

यह ज़रूरी नहीं है और सिर्फ़ तीसरे पक्ष के टैग क्रिएटिव के लिए मान्य है. तीसरे पक्ष के टैग वाले क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

ज़रूरी नहीं. इससे पता चलता है कि एट्रिब्यूशन के लिए, क्रिएटिव को रिटर्न पिंग का इंतज़ार करना होगा.

यह सिर्फ़ तब मान्य होता है, जब Campaign Manager 360 के ट्रैक किए गए विज्ञापन का इस्तेमाल, तीसरे पक्ष के विज्ञापन सर्वर पैरामीटर और ${DC_DBM_TOKEN} मैक्रो के साथ किया जाता है.

यह ज़रूरी नहीं है. साथ ही, यह सिर्फ़ तीसरे पक्ष के टैग क्रिएटिव या तीसरे पक्ष के वीएएसटी टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के टैग वाले क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

ज़रूरी नहीं. इससे क्रिएटिव के बड़े होने की दिशा तय होती है.

यह ज़रूरी है और सिर्फ़ तीसरे पक्ष के बड़े होने वाले क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के बड़े होने वाले क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनका होस्टिंग सोर्स यह होता है:

  • HOSTING_SOURCE_THIRD_PARTY

creativeType के साथ जोड़ें:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

ज़रूरी नहीं. इससे पता चलता है कि क्रिएटिव पर कर्सर घुमाने से, वह अपने-आप बड़ा हो जाएगा.

यह ज़रूरी नहीं है और सिर्फ़ तीसरे पक्ष के बड़े होने वाले क्रिएटिव के लिए मान्य है. तीसरे पक्ष के बड़े होने वाले क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनका होस्टिंग सोर्स यह होता है:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

ज़रूरी नहीं. तीसरे पक्ष के VAST टैग क्रिएटिव के लिए, VAST टैग का यूआरएल.

यह ज़रूरी है और सिर्फ़ तीसरे पक्ष के वीएएसटी टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि तीसरे पक्ष के VAST टैग क्रिएटिव के लिए, VPAID (डिजिटल वीडियो प्‍लेयर-विज्ञापन इंटरफ़ेस) की ज़रूरत है.

यह सिर्फ़ आउटपुट के लिए है और तीसरे पक्ष के वीएएसटी टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि तीसरे पक्ष के वीएएसटी टैग क्रिएटिव के लिए, HTML5 वीडियो की सुविधा ज़रूरी है.

यह सिर्फ़ आउटपुट के लिए है और तीसरे पक्ष के वीएएसटी टैग क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के वीएएसटी टैग क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. उन लाइन आइटम के आईडी जिनसे यह क्रिएटिव जुड़ा है.

किसी क्रिएटिव को लाइन आइटम से जोड़ने के लिए, LineItem.creative_ids का इस्तेमाल करें.
mp3Audio

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि तीसरे पक्ष का ऑडियो क्रिएटिव, MP3 फ़ॉर्मैट के साथ काम करता है.

यह सिर्फ़ आउटपुट के लिए है और तीसरे पक्ष के ऑडियो क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के ऑडियो क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि तीसरे पक्ष की ऑडियो ऐसेट, OGG के साथ काम करती है.

यह सिर्फ़ आउटपुट के लिए है और तीसरे पक्ष के ऑडियो क्रिएटिव के लिए मान्य है.

तीसरे पक्ष के ऑडियो क्रिएटिव, ऐसे क्रिएटिव होते हैं जिनमें ये hostingSource शामिल होते हैं:

  • HOSTING_SOURCE_THIRD_PARTY

इन creativeType के साथ जोड़ा गया:

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

ज़रूरी नहीं. क्या क्रिएटिव को एआई लेबलिंग के स्थानीय कानूनों वाले इलाकों में दिखाए जाने पर, उसे एआई का इस्तेमाल करके बनाया गया या बदला गया के तौर पर लेबल करना है.

HostingSource

किसी क्रिएटिव के लिए, होस्टिंग के संभावित सोर्स. इससे पता चलता है कि क्रिएटिव कहां बनाया गया है और कहां होस्ट किया गया है.

Enums
HOSTING_SOURCE_UNSPECIFIED इस वर्शन में, होस्टिंग सोर्स की जानकारी नहीं दी गई है या वह अज्ञात है.
HOSTING_SOURCE_CM

Campaign Manager 360 से सिंक किया गया क्रिएटिव.

इस तरह की होस्टिंग के लिए, बनाने और अपडेट करने के तरीके इस्तेमाल नहीं किए जा सकते.
HOSTING_SOURCE_THIRD_PARTY

तीसरे पक्ष के विज्ञापन सर्वर (3PAS) से होस्ट किया गया क्रिएटिव.

अगर creativeType इनमें से कोई एक है, तो इस तरह की होस्टिंग के लिए, बनाने और अपडेट करने के तरीके काम करते हैं:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

DV360 में बनाया गया और Campaign Manager 360 से होस्ट किया गया क्रिएटिव.

अगर creativeType इनमें से कोई एक है, तो इस होस्टिंग टाइप के लिए, बनाने और अपडेट करने के तरीके काम करते हैं:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Studio में बनाया गया और Campaign Manager 360 से होस्ट किया गया रिच मीडिया क्रिएटिव.

इस तरह की होस्टिंग के लिए, बनाने और अपडेट करने के तरीके इस्तेमाल नहीं किए जा सकते.

CreativeAttribute

किसी क्रिएटिव के संभावित एट्रिब्यूट.

Enums
CREATIVE_ATTRIBUTE_UNSPECIFIED इस वर्शन में, क्रिएटिव एट्रिब्यूट की जानकारी नहीं दी गई है या इसके बारे में पता नहीं है.
CREATIVE_ATTRIBUTE_VAST क्रिएटिव, एक VAST क्रिएटिव है.
CREATIVE_ATTRIBUTE_VPAID_LINEAR क्रिएटिव, लीनियर वीपीएआईडी क्रिएटिव है.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR क्रिएटिव, नॉन-लीनियर वीपीएआईडी क्रिएटिव है.

ReviewStatusInfo

क्रिएटिव के लिए समीक्षा की स्थितियां.

JSON के काेड में दिखाना 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
फ़ील्ड
approvalStatus

enum (ApprovalStatus)

यह क्रिएटिव को दिखाने के लिए ज़रूरी बुनियादी अनुमति को दिखाता है. creativeAndLandingPageReviewStatus और contentAndPolicyReviewStatus की खास जानकारी.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

क्रिएटिव के लिए, क्रिएटिव और लैंडिंग पेज की समीक्षा का स्टेटस.
contentAndPolicyReviewStatus

enum (ReviewStatus)

क्रिएटिव के लिए, कॉन्टेंट और नीति की समीक्षा की स्थिति.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

क्रिएटिव के लिए, एक्सचेंज की समीक्षा की स्थितियां.

स्वीकृति स्थिति

अनुमति की स्थिति के संभावित टाइप. यह creativeAndLandingPageReviewStatus और contentAndPolicyReviewStatus की खास जानकारी है.

Enums
APPROVAL_STATUS_UNSPECIFIED इस वर्शन में, टाइप की वैल्यू नहीं दी गई है या इसकी जानकारी मौजूद नहीं है.
APPROVAL_STATUS_PENDING_NOT_SERVABLE क्रिएटिव की अब भी समीक्षा की जा रही है और उसे दिखाया नहीं जा सकता.
APPROVAL_STATUS_PENDING_SERVABLE क्रिएटिव और लैंडिंग पेज की समीक्षा हो चुकी है और क्रिएटिव को दिखाया जा सकता है. हालांकि, कॉन्टेंट और नीति की समीक्षा होना बाकी है.
APPROVAL_STATUS_APPROVED_SERVABLE क्रिएटिव और लैंडिंग पेज की समीक्षा के साथ-साथ, कॉन्टेंट और नीति की समीक्षा को मंज़ूरी मिल गई हो. क्रिएटिव को दिखाया जा सकता है.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE क्रिएटिव में कोई समस्या है. इसे दिखाने से पहले, समस्या को ठीक करना होगा.

ReviewStatus

समीक्षा की स्थिति के संभावित टाइप.

Enums
REVIEW_STATUS_UNSPECIFIED इस वर्शन में, टाइप की वैल्यू नहीं दी गई है या इसकी जानकारी मौजूद नहीं है.
REVIEW_STATUS_APPROVED क्रिएटिव को मंज़ूरी मिल गई है.
REVIEW_STATUS_REJECTED क्रिएटिव को अस्वीकार कर दिया गया है.
REVIEW_STATUS_PENDING क्रिएटिव की समीक्षा होना बाकी है.

ExchangeReviewStatus

क्रिएटिव के लिए एक्सचेंज की समीक्षा की स्थिति.

JSON के काेड में दिखाना 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
फ़ील्ड
exchange

enum (Exchange)

क्रिएटिव की समीक्षा करने वाला एक्सचेंज.
status

enum (ReviewStatus)

एक्सचेंज की समीक्षा की स्थिति.

AssetAssociation

क्रिएटिव के लिए ऐसेट असोसिएशन.

JSON के काेड में दिखाना 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
फ़ील्ड
asset

object (Asset)

ज़रूरी नहीं. इससे जुड़ी ऐसेट.
role

enum (AssetRole)

ज़रूरी नहीं. क्रिएटिव के लिए इस ऐसेट की भूमिका.

एसेट

कोई एक ऐसेट.

JSON के काेड में दिखाना 
{
  "mediaId": string,
  "content": string
}
फ़ील्ड
mediaId

string (int64 format)

अपलोड की गई ऐसेट का मीडिया आईडी. यह ऐसेट के लिए यूनीक आइडेंटिफ़ायर होता है. इस आईडी को अन्य एपीआई कॉल में पास किया जा सकता है. उदाहरण के लिए, ऐसेट को क्रिएटिव से जोड़ने के लिए creatives.create.

मीडिया आईडी स्पेस को 5 अप्रैल, 2023 को अपडेट किया गया. 5 अप्रैल, 2023 से पहले कैश मेमोरी में सेव किए गए मीडिया आईडी अपडेट करें. इसके लिए, जुड़े हुए क्रिएटिव रिसॉर्स से नया मीडिया आईडी वापस पाएं या ऐसेट को फिर से अपलोड करें.
content

string

ऐसेट का कॉन्टेंट. अपलोड की गई ऐसेट के लिए, कॉन्टेंट ही सर्विंग पाथ होता है.

AssetRole

क्रिएटिव के लिए इस ऐसेट की भूमिका.

Enums
ASSET_ROLE_UNSPECIFIED इस वर्शन में, ऐसेट की भूमिका के बारे में नहीं बताया गया है या इसकी जानकारी नहीं है.
ASSET_ROLE_MAIN ऐसेट, क्रिएटिव की मुख्य ऐसेट है.
ASSET_ROLE_BACKUP एसेट, क्रिएटिव की बैकअप एसेट है.
ASSET_ROLE_POLITE_LOAD यह ऐसेट, क्रिएटिव की आसान लोड ऐसेट है.
ASSET_ROLE_HEADLINE

नेटिव क्रिएटिव की हेडलाइन.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसकी लंबाई 25 वर्णों से ज़्यादा नहीं होनी चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

नेटिव क्रिएटिव की लंबी हेडलाइन.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसमें 50 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

नेटिव क्रिएटिव के मुख्य हिस्से का टेक्स्ट.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसमें 90 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

नेटिव क्रिएटिव के मुख्य हिस्से का लंबा टेक्स्ट.

content को UTF-8 कोड में बदला जाना चाहिए. साथ ही, इसमें 150 से ज़्यादा वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

क्रिएटिव में दिखाने के लिए, लैंडिंग पेज यूआरएल का छोटा और आसान वर्शन. इस यूआरएल से लोगों को पता चलता है कि क्रिएटिव पर क्लिक करने के बाद, वे किस वेबसाइट पर पहुंचेंगे.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसकी लंबाई 30 वर्णों से ज़्यादा नहीं होनी चाहिए.

उदाहरण के लिए, अगर लैंडिंग पेज का यूआरएल 'http://www.example.com/page' है, तो कैप्शन यूआरएल 'example.com' हो सकता है. प्रोटोकॉल (http://) ज़रूरी नहीं है. हालांकि, यूआरएल में खाली जगह या खास वर्ण नहीं होने चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

नेटिव क्रिएटिव के कॉल-टू-ऐक्शन बटन पर इस्तेमाल किया जाने वाला टेक्स्ट.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसकी लंबाई 15 वर्णों से ज़्यादा नहीं होनी चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

वह टेक्स्ट जो विज्ञापन देने वाले व्यक्ति या कंपनी या ब्रैंड के नाम की पहचान करता है.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसकी लंबाई 25 वर्णों से ज़्यादा नहीं होनी चाहिए.

यह भूमिका सिर्फ़ इन creativeType में काम करती है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Google Play Store या iOS ऐप स्टोर में आपके ऐप्लिकेशन की कीमत (उदाहरण के लिए, 5.99 डॉलर).

ध्यान दें कि यह वैल्यू, स्टोर में मौजूद असल वैल्यू के साथ अपने-आप सिंक नहीं होती. यह हमेशा वही होगा जो क्रिएटिव को सेव करते समय दिया गया था.

content को UTF-8 में एन्कोड किया जाना चाहिए. साथ ही, इसकी लंबाई 15 वर्णों से ज़्यादा नहीं होनी चाहिए.

इस भूमिका के लिए, ऐसेट को सिर्फ़ पढ़ा जा सकता है.
ASSET_ROLE_ANDROID_APP_ID

Google Play Store में मौजूद किसी Android ऐप्लिकेशन का आईडी.

यह आईडी, ऐप्लिकेशन के Google Play Store यूआरएल में ‘id’ के बाद देखा जा सकता है. उदाहरण के लिए, https://play.google.com/store/apps/details?id=com.company.appname में आइडेंटिफ़ायर com.company.appname है.

इस भूमिका के लिए, ऐसेट को सिर्फ़ पढ़ा जा सकता है.
ASSET_ROLE_IOS_APP_ID

Apple App Store में मौजूद किसी iOS ऐप्लिकेशन का आईडी.

यह आईडी नंबर, Apple App Store के यूआरएल में "id" के ठीक बाद मौजूद नंबर की स्ट्रिंग के तौर पर देखा जा सकता है. उदाहरण के लिए, https://apps.apple.com/us/app/gmail-email-by-google/id422689480 में आईडी 422689480 है.

इस भूमिका के लिए, ऐसेट को सिर्फ़ पढ़ा जा सकता है.
ASSET_ROLE_RATING

Google Play Store या iOS ऐप स्टोर में किसी ऐप्लिकेशन की रेटिंग.

ध्यान दें कि यह वैल्यू, स्टोर में मौजूद असल रेटिंग के साथ अपने-आप सिंक नहीं होती. यह हमेशा वही होगा जो क्रिएटिव को सेव करते समय दिया गया था.

इस भूमिका के लिए, ऐसेट को सिर्फ़ पढ़ा जा सकता है.
ASSET_ROLE_ICON

क्रिएटिव का आइकॉन.

यह भूमिका सिर्फ़ इन creativeType में काम करती है और ज़रूरी है:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

नेटिव वीडियो क्रिएटिव की कवर इमेज.

यह भूमिका सिर्फ़ इन creativeType में काम करती है और ज़रूरी है:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

क्रिएटिव में इस्तेमाल किया जाने वाला मुख्य रंग.

यह भूमिका सिर्फ़ इन creativeType में काम करती है और ज़रूरी है:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

क्रिएटिव में इस्तेमाल किया जाने वाला ऐक्सेंट कलर.

यह भूमिका सिर्फ़ इन creativeType में काम करती है और ज़रूरी है:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

क्या क्रिएटिव में इमेज ऐसेट का इस्तेमाल करना ज़रूरी है.

यह भूमिका सिर्फ़ इन creativeType में काम करती है और ज़रूरी है:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

क्या क्रिएटिव पर, ऐसेट को बेहतर बनाने की सुविधा लागू की जा सकती है.

यह भूमिका सिर्फ़ इन creativeType में काम करती है और ज़रूरी है:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

क्रिएटिव का एग्ज़िट इवेंट.

JSON के काेड में दिखाना 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
फ़ील्ड
type

enum (ExitEventType)

ज़रूरी है. एग्ज़िट इवेंट का टाइप.
url

string

ज़रूरी है. एग्ज़िट इवेंट का क्लिक-थ्रू यूआरएल. यह तब ज़रूरी है, जब type:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

ज़रूरी नहीं. एग्ज़िट इवेंट के क्लिक टैग का नाम.

एक क्रिएटिव में, हर एसेट का नाम यूनीक होना चाहिए.

सिर्फ़ इमेज ऐसेट वाले क्रिएटिव के लिए, इसे खाली छोड़ दें या सेट न करें.
reportingName

string

ज़रूरी नहीं. रिपोर्ट में इस इवेंट की पहचान करने के लिए इस्तेमाल किया जाने वाला नाम. सिर्फ़ इमेज ऐसेट वाले क्रिएटिव के लिए, इसे खाली छोड़ दें या सेट न करें.

ExitEventType

एग्ज़िट इवेंट का टाइप.

Enums
EXIT_EVENT_TYPE_UNSPECIFIED इस वर्शन में, एग्ज़िट इवेंट टाइप की जानकारी नहीं दी गई है या इसके बारे में जानकारी नहीं है.
EXIT_EVENT_TYPE_DEFAULT एग्ज़िट इवेंट, डिफ़ॉल्ट इवेंट होता है.
EXIT_EVENT_TYPE_BACKUP एग्ज़िट इवेंट, बैकअप एग्ज़िट इवेंट है. किसी क्रिएटिव में, बैकअप एग्ज़िट इवेंट एक से ज़्यादा हो सकते हैं.

TimerEvent

क्रिएटिव का टाइमर इवेंट.

JSON के काेड में दिखाना 
{
  "name": string,
  "reportingName": string
}
फ़ील्ड
name

string

ज़रूरी है. टाइमर इवेंट का नाम.
reportingName

string

ज़रूरी है. रिपोर्ट में इस टाइमर इवेंट की पहचान करने के लिए इस्तेमाल किया जाने वाला नाम.

CounterEvent

क्रिएटिव का काउंटर इवेंट.

JSON के काेड में दिखाना 
{
  "name": string,
  "reportingName": string
}
फ़ील्ड
name

string

ज़रूरी है. काउंटर इवेंट का नाम.
reportingName

string

ज़रूरी है. रिपोर्ट में इस काउंटर इवेंट की पहचान करने के लिए इस्तेमाल किया जाने वाला नाम.

AudioVideoOffset

ऑडियो या वीडियो को कितनी देर तक चलाया गया.

JSON के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
फ़ील्ड
ऑफ़सेट की वैल्यू. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
percentage

string (int64 format)

ज़रूरी नहीं. ऑडियो या वीडियो की अवधि के प्रतिशत में ऑफ़सेट.
seconds

string (int64 format)

ज़रूरी नहीं. ऑडियो या वीडियो की शुरुआत से सेकंड में ऑफ़सेट.
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

UniversalAdId

रजिस्ट्री से मिला क्रिएटिव आइडेंटिफ़ायर, जो सभी प्लैटफ़ॉर्म पर यूनीक होता है. यह वीएएसटी 4.0 स्टैंडर्ड का हिस्सा है.

JSON के काेड में दिखाना 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
फ़ील्ड
id

string

ज़रूरी नहीं. यूनीक क्रिएटिव आइडेंटिफ़ायर.
registry

enum (UniversalAdRegistry)

ज़रूरी नहीं. रजिस्ट्री, यूनीक क्रिएटिव आइडेंटिफ़ायर उपलब्ध कराती है.

UniversalAdRegistry

रजिस्ट्री, यूनिवर्सल विज्ञापन आईडी में यूनीक क्रिएटिव आइडेंटिफ़ायर उपलब्ध कराती है.

Enums
UNIVERSAL_AD_REGISTRY_UNSPECIFIED इस वर्शन में, यूनिवर्सल विज्ञापन रजिस्ट्री के बारे में नहीं बताया गया है या यह मौजूद नहीं है.
UNIVERSAL_AD_REGISTRY_OTHER यूनिवर्सल विज्ञापन आईडी देने के लिए, कस्टम प्रोवाइडर का इस्तेमाल करें.
UNIVERSAL_AD_REGISTRY_AD_ID यूनिवर्सल विज्ञापन आईडी देने के लिए, Ad-ID का इस्तेमाल करें.
UNIVERSAL_AD_REGISTRY_CLEARCAST यूनिवर्सल विज्ञापन आईडी देने के लिए, clearcast.co.uk का इस्तेमाल करें.
UNIVERSAL_AD_REGISTRY_DV360 यूनिवर्सल विज्ञापन आईडी देने के लिए, Display & Video 360 का इस्तेमाल करें.
UNIVERSAL_AD_REGISTRY_CM यूनिवर्सल विज्ञापन आईडी देने के लिए, Campaign Manager 360 का इस्तेमाल करें.

ThirdPartyUrl

ऑडियो या वीडियो क्रिएटिव के साथ होने वाले इंटरैक्शन को ट्रैक करने के लिए, तीसरे पक्ष के ट्रैकिंग यूआरएल.

JSON के काेड में दिखाना 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
फ़ील्ड
type

enum (ThirdPartyUrlType)

ज़रूरी नहीं. ट्रैकिंग यूआरएल से, इंटरैक्शन के टाइप को ट्रैक करना ज़रूरी है
url

string

ज़रूरी नहीं. इंटरैक्शन को ट्रैक करने के लिए इस्तेमाल किया जाने वाला ट्रैकिंग यूआरएल.

वैकल्पिक पाथ या क्वेरी स्ट्रिंग वाला यूआरएल दें. यह यूआरएल, https: से शुरू होना चाहिए. उदाहरण के लिए, https://www.example.com/path

ThirdPartyUrlType

तीसरे पक्ष के ट्रैकिंग यूआरएल से, इंटरैक्शन के टाइप को ट्रैक किया जाना चाहिए.

Enums
THIRD_PARTY_URL_TYPE_UNSPECIFIED तीसरे पक्ष के यूआरएल के टाइप के बारे में नहीं बताया गया है या इस वर्शन में इसकी जानकारी नहीं है.
THIRD_PARTY_URL_TYPE_IMPRESSION इसका इस्तेमाल, ऑडियो या वीडियो बफ़रिंग पूरी होने के बाद, क्रिएटिव के इंप्रेशन की गिनती करने के लिए किया जाता है.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING इसका इस्तेमाल, ऑडियो या वीडियो पर उपयोगकर्ता के क्लिक को ट्रैक करने के लिए किया जाता है.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि कोई उपयोगकर्ता कितनी बार ऑडियो या वीडियो चलाना शुरू करता है.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को उसकी कुल अवधि के 25% हिस्से तक कितनी बार चलाया गया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को उसकी कुल अवधि के 50% तक कितनी बार चलाया गया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को उसकी कुल अवधि के 75% हिस्से तक कितनी बार चलाया गया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो को कितनी बार आखिर तक चलाया गया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि किसी उपयोगकर्ता ने ऑडियो या वीडियो को कितनी बार म्यूट किया.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि उपयोगकर्ता ने ऑडियो या वीडियो को कितनी बार रोका.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि कोई उपयोगकर्ता, ऑडियो या वीडियो को कितनी बार फिर से चलाता है.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि कोई उपयोगकर्ता, प्लेयर को कितनी बार फ़ुल-स्क्रीन साइज़ में बड़ा करता है.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि उपयोगकर्ता ने ऑडियो या वीडियो को कितनी बार रोका.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि कोई उपयोगकर्ता कितनी बार कस्टम क्लिक करता है. जैसे, वीडियो हॉट स्पॉट पर क्लिक करना.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP इसका इस्तेमाल, ऑडियो या वीडियो को स्किप किए जाने की संख्या को ट्रैक करने के लिए किया जाता है.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि ऑडियो या वीडियो, progressOffset के तय किए गए ऑफ़सेट तक कितनी बार चलता है.

ट्रांसकोड

यह ट्रांसकोड की गई ऑडियो या वीडियो फ़ाइल के बारे में जानकारी दिखाता है.

JSON के काेड में दिखाना 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
फ़ील्ड
name

string

ज़रूरी नहीं. ट्रांसकोड की गई फ़ाइल का नाम.
mimeType

string

ज़रूरी नहीं. ट्रांसकोड की गई फ़ाइल का एमआईएमई टाइप.
transcoded

boolean

ज़रूरी नहीं. इससे पता चलता है कि ट्रांसकोडिंग पूरी हुई या नहीं.
dimensions

object (Dimensions)

ज़रूरी नहीं. ट्रांसकोड किए गए वीडियो के डाइमेंशन.
bitRateKbps

string (int64 format)

ज़रूरी नहीं. ट्रांसकोड किए गए वीडियो का ट्रांसकोडिंग बिट रेट, किलोबिट प्रति सेकंड में.
frameRate

number

ज़रूरी नहीं. ट्रांसकोड किए गए वीडियो का फ़्रेम रेट, फ़्रेम प्रति सेकंड में.
audioBitRateKbps

string (int64 format)

ज़रूरी नहीं. ट्रांसकोड किए गए वीडियो की ऑडियो स्ट्रीम का बिट रेट या ट्रांसकोड किए गए ऑडियो का बिट रेट, किलोबिट प्रति सेकंड में.
audioSampleRateHz

string (int64 format)

ज़रूरी नहीं. ट्रांसकोड किए गए वीडियो की ऑडियो स्ट्रीम का सैंपल रेट या ट्रांसकोड किए गए ऑडियो का सैंपल रेट, हर्ट्ज़ में.
fileSizeBytes

string (int64 format)

ज़रूरी नहीं. ट्रांसकोड की गई फ़ाइल का साइज़, बाइट में.

CmTrackingAd

Campaign Manager 360 का ट्रैक किया गया विज्ञापन.

JSON के काेड में दिखाना 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
फ़ील्ड
cmPlacementId

string (int64 format)

ज़रूरी नहीं. Campaign Manager 360 के ट्रैकिंग विज्ञापन का प्लेसमेंट आईडी.
cmCreativeId

string (int64 format)

ज़रूरी नहीं. Campaign Manager 360 ट्रैकिंग विज्ञापन का क्रिएटिव आईडी.
cmAdId

string (int64 format)

ज़रूरी नहीं. Campaign Manager 360 ट्रैकिंग विज्ञापन का विज्ञापन आईडी.

ObaIcon

किसी क्रिएटिव के लिए ओबीए आइकॉन

JSON के काेड में दिखाना 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
फ़ील्ड
resourceUrl

string

ज़रूरी नहीं. ओबीए आइकॉन के संसाधन का यूआरएल.
resourceMimeType

string

ज़रूरी नहीं. OBA आइकॉन संसाधन का एमआईएमई टाइप.
position

enum (ObaIconPosition)

ज़रूरी नहीं. क्रिएटिव पर ओबीए आइकॉन की पोज़िशन.
dimensions

object (Dimensions)

ज़रूरी नहीं. ओबीए आइकॉन के डाइमेंशन.
program

string

ज़रूरी नहीं. ओबीए आइकॉन का प्रोग्राम. उदाहरण के लिए: “AdChoices”.
landingPageUrl

string

ज़रूरी है. ओबीए आइकॉन का लैंडिंग पेज यूआरएल.

सिर्फ़ इन डोमेन के यूआरएल इस्तेमाल किए जा सकते हैं:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

ज़रूरी है. ओबीए आइकॉन का क्लिक ट्रैकिंग यूआरएल.

सिर्फ़ इन डोमेन के यूआरएल इस्तेमाल किए जा सकते हैं:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

ज़रूरी है. ओबीए आइकॉन का व्यू ट्रैकिंग यूआरएल.

सिर्फ़ इन डोमेन के यूआरएल इस्तेमाल किए जा सकते हैं:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

क्रिएटिव पर ओबीए आइकॉन की पोज़िशन.

Enums
OBA_ICON_POSITION_UNSPECIFIED ओबीए आइकॉन की पोज़िशन तय नहीं की गई है.
OBA_ICON_POSITION_UPPER_RIGHT क्रिएटिव के ऊपर दाईं ओर.
OBA_ICON_POSITION_UPPER_LEFT क्रिएटिव के ऊपर बाईं ओर.
OBA_ICON_POSITION_LOWER_RIGHT क्रिएटिव के निचले हिस्से में दाईं ओर.
OBA_ICON_POSITION_LOWER_LEFT क्रिएटिव के निचले हिस्से में बाईं ओर.

ExpandingDirection

तीसरे पक्ष के बड़े होने वाले क्रिएटिव के बड़े होने की दिशा.

Enums
EXPANDING_DIRECTION_UNSPECIFIED बड़ा होने की दिशा नहीं बताई गई है.
EXPANDING_DIRECTION_NONE यह किसी भी दिशा में नहीं बढ़ता.
EXPANDING_DIRECTION_UP बड़ा किया जा रहा है.
EXPANDING_DIRECTION_DOWN नीचे की ओर बड़ा होता है.
EXPANDING_DIRECTION_LEFT बाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_RIGHT दाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_UP_AND_LEFT यह ऊपर और बाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_UP_AND_RIGHT यह ऊपर और दाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_DOWN_AND_LEFT यह नीचे और बाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_DOWN_AND_RIGHT यह नीचे और दाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_UP_OR_DOWN यह ऊपर या नीचे की ओर बड़ा होता है.
EXPANDING_DIRECTION_LEFT_OR_RIGHT यह बाईं या दाईं ओर बड़ा होता है.
EXPANDING_DIRECTION_ANY_DIAGONAL यह किसी भी डायगनल दिशा में आगे बढ़ सकता है.

तरीके

create

 नया क्रिएटिव बनाता है.

delete

 किसी क्रिएटिव को मिटाता है.

get

 क्रिएटिव फ़ेच करता है.

list

 विज्ञापन देने वाले व्यक्ति या कंपनी के क्रिएटिव की सूची दिखाता है.

patch

 किसी मौजूदा क्रिएटिव को अपडेट करता है.