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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
फ़ील्ड
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 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

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)

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

containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

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

अगर इस फ़ील्ड को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING पर सेट किया जाता है, तो:

  • विज्ञापन देने वाले इस व्यक्ति या कंपनी के लिए बनाए गए किसी भी नए लाइन आइटम को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING असाइन किया जाएगा. हालांकि, ऐसा तब होगा, जब कोई और जानकारी न दी गई हो.
  • विज्ञापन देने वाले इस व्यक्ति या कंपनी के ऐसे सभी मौजूदा लाइन आइटम जिनमें कोई वैल्यू सेट नहीं है उन्हें एक दिन के अंदर DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING पर अपडेट कर दिया जाएगा.
defaultBusinessName

string

ज़रूरी नहीं. विज्ञापन देने वाले व्यक्ति या कंपनी के कारोबार का डिफ़ॉल्ट नाम.

अगर विज्ञापन देने वाले इस व्यक्ति या कंपनी ने कारोबार का नाम नहीं दिया है, तो YouTube और मांग बढ़ाने में मदद करने वाले विज्ञापनों में इस वैल्यू का इस्तेमाल किया जाता है.

defaultLogoAssetId

string (int64 format)

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

अगर विज्ञापन देने वाले इस व्यक्ति या कंपनी ने लोगो ऐसेट नहीं दी है, तो YouTube और मांग बढ़ाने में मदद करने वाले विज्ञापनों के लिए, इस ऐसेट आईडी का इस्तेमाल किया जाएगा.

एपीआई का इस्तेमाल करके इस ऐसेट को अपलोड करने के लिए, आपको advertisers.adAssets.upload का इस्तेमाल करना होगा.

AdvertiserGeneralConfig

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

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

string

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

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

timeZone

string

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले व्यक्ति या कंपनी के टाइम ज़ोन का स्टैंडर्ड टीज़ेड डेटाबेस नाम. उदाहरण के लिए, 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 के काेड में दिखाना
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
ज़रूरी है. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 के इस ऐडवर्टाइज़र खाते से जुड़े वीडियो क्रिएटिव का इस्तेमाल कर सके. इससे Google, ऐडवर्टाइज़र के टेलीविज़न कैंपेन से जुड़ी रिपोर्टिंग और सुविधाएं उपलब्ध करा पाएगा.

यह सिर्फ़ तब लागू होता है, जब विज्ञापन देने वाले व्यक्ति या कंपनी के पास 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

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