REST Resource: advertisers.adGroups

संसाधन: AdGroup

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

JSON के काेड में दिखाना
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. विज्ञापन ग्रुप का संसाधन नाम.

advertiserId

string (int64 format)

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

adGroupId

string (int64 format)

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

lineItemId

string (int64 format)

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

displayName

string

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

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

adGroupFormat

enum (AdGroupFormat)

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

bidStrategy

object (BiddingStrategy)

ज़रूरी नहीं. विज्ञापन ग्रुप के लिए इस्तेमाल की गई बिडिंग की रणनीति. बिडिंग की रणनीति में सिर्फ़ youtubeAndPartnersBid और demandGenBid फ़ील्ड का इस्तेमाल किया जा सकता है.

entityStatus

enum (EntityStatus)

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

अगर विज्ञापन ग्रुप का पैरंट लाइन आइटम चालू नहीं है, तो विज्ञापन ग्रुप अपना बजट खर्च नहीं कर सकता. भले ही, उसकी स्थिति ENTITY_STATUS_ACTIVE हो.

targetingExpansion

object (TargetingExpansionConfig)

ज़रूरी नहीं. विज्ञापन ग्रुप की ऑप्टिमाइज़ की गई टारगेटिंग सेटिंग.

productFeedData

object (ProductFeedData)

ज़रूरी नहीं. इस विज्ञापन ग्रुप में प्रॉडक्ट फ़ीड की सेटिंग.

adGroupInventoryControl

object (AdGroupInventoryControl)

ज़रूरी नहीं. मांग बढ़ाने में मदद करने वाले विज्ञापन ग्रुप के लिए ज़रूरी है. विज्ञापन ग्रुप के लिए इन्वेंट्री कंट्रोल तय करता है.

AdGroupFormat

विज्ञापन ग्रुप का फ़ॉर्मैट.

Enums
AD_GROUP_FORMAT_UNSPECIFIED इस वर्शन में, फ़ॉर्मैट की वैल्यू नहीं दी गई है या इसकी जानकारी नहीं है.
AD_GROUP_FORMAT_IN_STREAM इन-स्ट्रीम विज्ञापन.
AD_GROUP_FORMAT_VIDEO_DISCOVERY फ़ीड में दिखने वाले विज्ञापन.
AD_GROUP_FORMAT_BUMPER बंपर विज्ञापन.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM स्किप न किए जा सकने वाले इन-स्ट्रीम विज्ञापन.
AD_GROUP_FORMAT_AUDIO स्किप न किए जा सकने वाले इन-स्ट्रीम ऑडियो विज्ञापन.
AD_GROUP_FORMAT_RESPONSIVE रिस्पॉन्सिव विज्ञापन.
AD_GROUP_FORMAT_REACH ज़्यादा पहुंच वाले विज्ञापन ग्रुप, जिनमें इन-स्ट्रीम और बंपर विज्ञापन शामिल हैं.
AD_GROUP_FORMAT_MASTHEAD मास्टहेड विज्ञापन, YouTube के होम पेज पर सबसे ऊपर दिखता है.
AD_GROUP_FORMAT_DEMAND_GEN मांग बढ़ाने में मदद करने वाले विज्ञापन.

ProductFeedData

प्रॉडक्ट फ़ीड की जानकारी.

JSON के काेड में दिखाना
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
फ़ील्ड
productMatchType

enum (ProductMatchType)

प्रॉडक्ट फ़ीड के हिसाब से प्रॉडक्ट कैसे चुने जाते हैं.

productMatchDimensions[]

object (ProductMatchDimension)

प्रॉडक्ट मैच करने के लिए इस्तेमाल किए गए डाइमेंशन की सूची.

isFeedDisabled

boolean

इससे पता चलता है कि प्रॉडक्ट फ़ीड ने प्रॉडक्ट दिखाने की सुविधा से ऑप्ट-आउट किया है या नहीं.

ProductMatchType

प्रॉडक्ट मैच करने के तरीकों के टाइप.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED जानकारी नहीं दी गई या मौजूद नहीं है.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS सभी प्रॉडक्ट का मिलान हो गया है.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS खास प्रॉडक्ट चुने गए हैं.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL कस्टम लेबल के हिसाब से प्रॉडक्ट मैच करें.

ProductMatchDimension

प्रॉडक्ट मैच करने के लिए इस्तेमाल किया जाने वाला डाइमेंशन.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
वह डाइमेंशन और वैल्यू जिसके आधार पर प्रॉडक्ट का मिलान करना है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
productOfferId

string

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

customLabel

object (CustomLabel)

कस्टम लेबल, ताकि लेबल वाले सभी प्रॉडक्ट मैच हो सकें.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

CustomLabel

कस्टम लेबल की कुंजी और वैल्यू.

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

enum (CustomLabelKey)

लेबल की कुंजी.

value

string

लेबल की वैल्यू.

CustomLabelKey

कस्टम लेबल की कुंजी

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED जानकारी नहीं दी गई या मौजूद नहीं है.
CUSTOM_LABEL_KEY_0 मुख्य इंडेक्स 0.
CUSTOM_LABEL_KEY_1 मुख्य इंडेक्स 1.
CUSTOM_LABEL_KEY_2 बटन 2.
CUSTOM_LABEL_KEY_3 बटन 3.
CUSTOM_LABEL_KEY_4 बटन 4.

AdGroupInventoryControl

विज्ञापन ग्रुप का इन्वेंट्री कंट्रोल.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
विज्ञापन ग्रुप का इन्वेंट्री कंट्रोल. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

इन्वेंट्री की रणनीति.

selectedInventories

object (SelectedInventories)

चुनी गई इन्वेंट्री.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

AdGroupInventoryStrategy

विज्ञापन ग्रुप के लिए इन्वेंट्री की रणनीति.

Enums
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED जानकारी नहीं दी गई या मौजूद नहीं है.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY विज्ञापन ग्रुप को Google और Display Network की सभी इन्वेंट्री के लिए ऑप्ट-इन किया गया है.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY विज्ञापन ग्रुप ने Google की सभी इन्वेंट्री के लिए ऑप्ट-इन किया हो.

SelectedInventories

विज्ञापन ग्रुप का इन्वेंट्री कंट्रोल.

JSON के काेड में दिखाना
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
फ़ील्ड
allowYoutubeStream

boolean

विज्ञापन ग्रुप ने YouTube इन-स्ट्रीम इन्वेंट्री के लिए ऑप्ट-इन किया है या नहीं.

allowYoutubeShorts

boolean

विज्ञापन ग्रुप ने YouTube Shorts इन्वेंट्री के लिए ऑप्ट-इन किया है या नहीं.

allowYoutubeFeed

boolean

विज्ञापन ग्रुप ने YouTube के इन-फ़ीड इन्वेंट्री में ऑप्ट-इन किया है या नहीं.

allowDiscover

boolean

विज्ञापन ग्रुप ने डिस्कवर इन्वेंट्री के लिए ऑप्ट-इन किया है या नहीं.

allowGmail

boolean

विज्ञापन ग्रुप ने Gmail इन्वेंट्री के लिए ऑप्ट-इन किया है या नहीं.

allowGoogleDisplayNetwork

boolean

विज्ञापन ग्रुप ने Google Display Network की इन्वेंट्री के लिए ऑप्ट-इन किया है या नहीं.

तरीके

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

यह नया विज्ञापन ग्रुप बनाता है.

delete

इस तरीके का इस्तेमाल करके, किसी AdGroup को मिटाया जा सकता है.

get

विज्ञापन ग्रुप को ऐक्सेस करता है.

list

विज्ञापन ग्रुप की सूची दिखाता है.

patch

यह मौजूदा विज्ञापन ग्रुप को अपडेट करता है.