REST Resource: advertisers

संसाधन: विज्ञापन देने वाला

Display & Video 360 (DV360) में विज्ञापन देने वाला कोई व्यक्ति या कंपनी.

JSON के काेड में दिखाना 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले व्यक्ति या कंपनी के संसाधन का नाम.
advertiserId

string (int64 format)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले का यूनीक आईडी. सिस्टम से असाइन किया गया.
partnerId

string (int64 format)

ज़रूरी है. इम्यूटेबल. उस पार्टनर का यूनीक आईडी जिससे विज्ञापन देने वाला जुड़ा है.
displayName

string

ज़रूरी है. विज्ञापन देने वाले व्यक्ति या कंपनी का डिसप्ले नेम.

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

enum (EntityStatus)

ज़रूरी है. यह कंट्रोल करता है कि विज्ञापन देने वाले के इंसर्शन ऑर्डर और लाइन आइटम, अपने बजट खर्च कर सकते हैं या नहीं. साथ ही, यह भी कंट्रोल करता है कि वे इन्वेंट्री पर बिड लगा सकते हैं या नहीं.

  • ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED, और ENTITY_STATUS_SCHEDULED_FOR_DELETION वैल्यू इस्तेमाल की जा सकती हैं.
  • अगर इसकी वैल्यू ENTITY_STATUS_SCHEDULED_FOR_DELETION पर सेट है, तो विज्ञापन देने वाले व्यक्ति या कंपनी का खाता, मिटाने के लिए शेड्यूल किए जाने के 30 दिनों बाद मिटा दिया जाएगा.
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले को आखिरी बार अपडेट किए जाने का टाइमस्टैंप. सिस्टम से असाइन किया गया.

आरएफ़सी3339 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
generalConfig

object (AdvertiserGeneralConfig)

ज़रूरी है. विज्ञापन देने वाले की सामान्य सेटिंग.
adServerConfig

object (AdvertiserAdServerConfig)

ज़रूरी है. इम्यूटेबल. विज्ञापन देने वाले की, विज्ञापन सर्वर से जुड़ी सेटिंग.
creativeConfig

object (AdvertiserCreativeConfig)

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

object (AdvertiserDataAccessConfig)

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

object (IntegrationDetails)

विज्ञापन देने वाले के इंटिग्रेशन की जानकारी. फ़िलहाल, विज्ञापन देने वाले के लिए सिर्फ़ integrationCode लागू है. IntegrationDetails के अन्य फ़ील्ड का इस्तेमाल नहीं किया जा सकता. अगर इनका इस्तेमाल किया जाता है, तो इन्हें अनदेखा कर दिया जाएगा.
servingConfig

object (AdvertiserTargetingConfig)

विज्ञापन देने वाले की ओर से विज्ञापन दिखाने से जुड़ी टारगेटिंग सेटिंग.
prismaEnabled

boolean

Mediaocean (Prisma) के साथ इंटिग्रेशन चालू है या नहीं. इसे चालू करने का मतलब है कि आप इन शर्तों से सहमत हैं:

अपनी कंपनी की ओर से, मैं Mediaocean (Prisma) को Google को बजट सेगमेंट प्लान भेजने की अनुमति देता/देती हूं. साथ ही, मैं Google को DV360 से Mediaocean को रिपोर्टिंग और इनवॉइस भेजने की अनुमति देता/देती हूं. ऐसा, विज्ञापन देने वाले के लिए बजट प्लानिंग, बिलिंग, और मिलान करने के लिए किया जाएगा.
billingConfig

object (AdvertiserBillingConfig)

ज़रूरी है. विज्ञापन देने वाले व्यक्ति या कंपनी की बिलिंग से जुड़ी सेटिंग.

AdvertiserGeneralConfig

विज्ञापन देने वाले की सामान्य सेटिंग.

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

string

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

ऐसा यूआरएल दें जिसमें कोई पाथ या क्वेरी स्ट्रिंग न हो और जो http: या https: से शुरू हो. उदाहरण के लिए, http://www.example.com
timeZone

string

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले के टाइम ज़ोन के स्टैंडर्ड TZ डेटाबेस का नाम. उदाहरण के लिए, America/New_York.

ज़्यादा जानकारी के लिए, यहां जाएं: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

CM360 के हाइब्रिड ऐडवर्टाइज़र खातों का टाइम ज़ोन, उनसे जुड़े CM360 खाते के टाइम ज़ोन जैसा ही होता है. हालांकि, सिर्फ़ तीसरे पक्ष के ऐडवर्टाइज़र खातों का टाइम ज़ोन और पैरंट पार्टनर का टाइम ज़ोन एक जैसा होता है.
currencyCode

string

ज़रूरी है. इम्यूटेबल. विज्ञापन देने वाले की मुद्रा, ISO 4217 फ़ॉर्मैट में.

स्वीकार किए जाने वाले कोड और उनसे जुड़ी मुद्राएं:

मुद्रा कोड : मुद्रा का नाम

  • ARS : अर्जेंटीन पेसो
  • AUD : ऑस्ट्रेलियन डॉलर
  • BRL : ब्राज़ीलियन रियाल
  • CAD : कैनेडियन डॉलर
  • CHF : स्विस फ़्रैंक
  • CLP : चिलियन पेसो
  • CNY : चाइनीज़ युआन
  • COP : कोलंबियन पेसो
  • CZK : चेक कोरुना
  • DKK : डेनिश क्रोन
  • EGP : इजिप्शियन पाउंड
  • EUR : यूरो
  • GBP : ब्रिटिश पाउंड
  • HKD : हॉन्ग कॉन्ग डॉलर
  • HUF : हंगेरियन फ़ोरिंट
  • IDR : इंडोनेशियन रुपिया
  • ILS : इज़रायली शेकल
  • INR : भारतीय रुपया
  • JPY : जैपनीज़ येन
  • KRW : साउथ कोरियन वॉन
  • MXN : मेक्सिकन पेसो
  • MYR : मलेशियन रिंग्गिट
  • NGN : नाइजीरियन नाइरा
  • NOK : नॉर्वेजियन क्रोन
  • NZD : न्यूज़ीलैंड डॉलर
  • PEN : पेरुवियन न्यूवो सोल
  • PLN : पोलिश ज़्लॉटी
  • RON : न्यू रोमानियन ल्यू
  • RUB : रशियन रूबल
  • SEK : स्वीडिश क्रोना
  • TRY : तुर्किये लीरा
  • TWD : न्यू ताइवान डॉलर
  • USD : डॉलर
  • ZAR : साउथ अफ़्रीकन रैंड

AdvertiserAdServerConfig

विज्ञापन देने वाले की, विज्ञापन सर्वर से जुड़ी सेटिंग.

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

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
फ़ील्ड
यूनियन फ़ील्ड ad_server_config_scheme. ज़रूरी है. ad_server_config_scheme इनमें से कोई एक हो सकता है:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

विज्ञापन देने वाले उन लोगों या कंपनियों के लिए कॉन्फ़िगरेशन जो सिर्फ़ तीसरे पक्ष के विज्ञापन सर्वर का इस्तेमाल करती हैं.
cmHybridConfig

object (CmHybridConfig)

विज्ञापन देने वाली उन कंपनियों के लिए कॉन्फ़िगरेशन जो Campaign Manager 360 (CM360) और तीसरे पक्ष के विज्ञापन सर्वर, दोनों का इस्तेमाल करती हैं.

ThirdPartyOnlyConfig

उन विज्ञापन देने वालों के लिए सेटिंग जो सिर्फ़ तीसरे पक्ष के विज्ञापन सर्वर का इस्तेमाल करते हैं.

JSON के काेड में दिखाना 
{
  "pixelOrderIdReportingEnabled": boolean
}
फ़ील्ड
pixelOrderIdReportingEnabled

boolean

पिक्सल के लिए ऑर्डर आईडी की रिपोर्टिंग चालू है या नहीं. true पर सेट करने के बाद, यह वैल्यू नहीं बदली जा सकती.

CmHybridConfig

विज्ञापन देने वाली उन कंपनियों के लिए सेटिंग जो Campaign Manager 360 (CM360) और तीसरे पक्ष के विज्ञापन सर्वर, दोनों का इस्तेमाल करती हैं.

JSON के काेड में दिखाना 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
फ़ील्ड
cmAccountId

string (int64 format)

ज़रूरी है. इम्यूटेबल. DV360 का इस्तेमाल करके विज्ञापन देने वाले व्यक्ति या कंपनी से लिंक किए गए CM360 Floodlight कॉन्फ़िगरेशन का खाता आईडी.
cmFloodlightConfigId

string (int64 format)

ज़रूरी है. इम्यूटेबल. DV360 ऐडवर्टाइज़र खाते से लिंक किए गए CM360 के Floodlight कॉन्फ़िगरेशन का आईडी.
cmAdvertiserIds[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. CM360 विज्ञापन देने वाले व्यक्ति या कंपनी के उन आईडी का सेट जो CM360 Floodlight कॉन्फ़िगरेशन शेयर करते हैं.
cmSyncableSiteIds[]

string (int64 format)

CM360 की उन साइटों की सूची जिनके प्लेसमेंट, क्रिएटिव के तौर पर DV360 में सिंक किए जाएंगे.

अगर advertisers.create तरीके में यह मौजूद नहीं है या इसकी जानकारी खाली है, तो सिस्टम अपने-आप CM360 साइट बना देगा.

इस सूची से साइटों को हटाने पर, CM360 से सिंक किए गए DV360 क्रिएटिव मिटाए जा सकते हैं. कम से कम एक साइट के बारे में बताना ज़रूरी है.
dv360ToCmDataSharingEnabled

boolean

CM360 डेटा ट्रांसफ़र रिपोर्ट में DV360 का डेटा शामिल किया जाए या नहीं.
dv360ToCmCostReportingEnabled

boolean

CM360 में DV360 की लागत की रिपोर्ट करनी है या नहीं.
cmFloodlightLinkingAuthorized

boolean

ज़रूरी है. इम्यूटेबल. इस फ़ील्ड को true पर सेट करके, अपनी कंपनी की ओर से, दिए गए Floodlight कॉन्फ़िगरेशन से, Display & Video 360 का इस्तेमाल करने वाले विज्ञापन देने वाले के साथ जानकारी शेयर करने की अनुमति दी जाती है.

AdvertiserCreativeConfig

विज्ञापन देने वाले के क्रिएटिव से जुड़ी सेटिंग.

JSON के काेड में दिखाना 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
फ़ील्ड
iasClientId

string (int64 format)

Integral Ad Service (IAS) की ओर से उपलब्ध कराया गया, कैंपेन मॉनिटरिंग को कॉन्फ़िगर करने के लिए आईडी. DV360 सिस्टम, क्रिएटिव टैग में इस आईडी वाले एक IAS "कैंपेन मॉनिटर" टैग को जोड़ेगा.
obaComplianceDisabled

boolean

Google की 'इस विज्ञापन के बारे में जानकारी' सुविधा को बंद करना है या नहीं. यह सुविधा, ऑनलाइन व्यवहार के आधार पर विज्ञापन दिखाने (ओबीए) और कानूनी ज़रूरी शर्तों के लिए, आपके विज्ञापनों में बैज (कॉन्टेंट को विज्ञापन के तौर पर पहचानने के लिए) और पारदर्शिता की जानकारी ('इस विज्ञापन के बारे में जानकारी' से इंटरैक्ट करने पर) जोड़ती है. 'इस विज्ञापन के बारे में जानकारी' से, उपयोगकर्ताओं को दिखने वाले विज्ञापनों पर ज़्यादा कंट्रोल मिलता है. साथ ही, इससे आपको यह बताने में मदद मिलती है कि उन्हें आपका विज्ञापन क्यों दिख रहा है. ज़्यादा जानें.

अगर इस फ़ील्ड को true पर सेट किया जाता है, तो ध्यान रखें कि Display &Video 360 से दिखाए जाने वाले विज्ञापन, इन शर्तों के मुताबिक होने चाहिए:

  • Google Marketing Platform के साथ हुए आपके अनुबंध के मुताबिक, ऑनलाइन व्यवहार के आधार पर दिखने वाले विज्ञापन (ओबीए) के नियमों का पालन करना.
  • यूरोपियन इकनॉमिक एरिया (ईईए) में, पारदर्शिता से जुड़ी जानकारी शामिल करें. साथ ही, उपयोगकर्ताओं को विज्ञापनों में गैर-कानूनी कॉन्टेंट की शिकायत करने का कोई तरीका भी दें. अगर विज्ञापन पर बैज दिखाने, पारदर्शिता, और शिकायत करने के लिए किसी अन्य सलूशन का इस्तेमाल किया जा रहा है, तो आपको यह पक्का करना होगा कि उसमें पारदर्शिता से जुड़ी ज़रूरी जानकारी और गैर-कानूनी कॉन्टेंट की शिकायत करने का तरीका शामिल हो. साथ ही, आपको Google को गैर-कानूनी कॉन्टेंट की शिकायत करने के लिए, सही फ़ॉर्म का इस्तेमाल करके सूचना देनी होगी.
dynamicCreativeEnabled

boolean

विज्ञापन देने वाले के लिए डाइनैमिक क्रिएटिव चालू हैं या नहीं.
videoCreativeDataSharingAuthorized

boolean

इस फ़ील्ड को true पर सेट करके, अपनी कंपनी की ओर से Google को इस Display & Video 360 खाते से जुड़े वीडियो क्रिएटिव का इस्तेमाल करने की अनुमति दी जाती है. इससे, विज्ञापन देने वाले के टेलिविज़न कैंपेन से जुड़ी रिपोर्टिंग और सुविधाएं उपलब्ध कराई जा सकती हैं.

यह सिर्फ़ तब लागू होता है, जब विज्ञापन देने वाले के पास CM360 hybrid विज्ञापन सर्वर कॉन्फ़िगरेशन हो.

AdvertiserDataAccessConfig

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

JSON के काेड में दिखाना 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
फ़ील्ड
sdfConfig

object (AdvertiserSdfConfig)

विज्ञापन देने वाले के लिए स्ट्रक्चर्ड डेटा फ़ाइलों (एसडीएफ़) की सेटिंग.

अगर इसके लिए सेटिंग तय नहीं की गई है, तो पैरंट पार्टनर की एसडीएफ़ सेटिंग का इस्तेमाल किया जाता है.

AdvertiserSdfConfig

विज्ञापन देने वाले की स्ट्रक्चर्ड डेटा फ़ाइलों (एसडीएफ़) की सेटिंग.

JSON के काेड में दिखाना 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
फ़ील्ड
overridePartnerSdfConfig

boolean

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

डिफ़ॉल्ट रूप से, विज्ञापन देने वाले को पैरंट पार्टनर से एसडीएफ़ कॉन्फ़िगरेशन इनहेरिट होता है. पार्टनर कॉन्फ़िगरेशन को बदलने के लिए, इस फ़ील्ड को true पर सेट करें और sdfConfig में नया कॉन्फ़िगरेशन दें.
sdfConfig

object (SdfConfig)

विज्ञापन देने वाले व्यक्ति या कंपनी के लिए एसडीएफ़ कॉन्फ़िगरेशन.

  • overridePartnerSdfConfig की वैल्यू true होने पर, यह एट्रिब्यूट देना ज़रूरी है.
  • सिर्फ़ तब आउटपुट करें, जब overridePartnerSdfConfig false हो.

AdvertiserTargetingConfig

विज्ञापन देने वाले की ओर से विज्ञापन दिखाने से जुड़ी टारगेटिंग सेटिंग.

JSON के काेड में दिखाना 
{
  "exemptTvFromViewabilityTargeting": boolean
}
फ़ील्ड
exemptTvFromViewabilityTargeting

boolean

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

AdvertiserBillingConfig

विज्ञापन देने वाले व्यक्ति या कंपनी की बिलिंग से जुड़ी सेटिंग.

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

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले को असाइन की गई बिलिंग प्रोफ़ाइल का आईडी.

तरीके

audit

 विज्ञापन देने वाले की ऑडिटिंग करता है.

create

 नया विज्ञापन देने वाला बनाता है.

delete

 विज्ञापन देने वाले को मिटाता है.

editAssignedTargetingOptions

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

get

 विज्ञापन देने वाला मिलता है.

list

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

listAssignedTargetingOptions

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

patch

 विज्ञापन देने वाले किसी मौजूदा खाते की जानकारी अपडेट करता है.