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 के काेड में दिखाना
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
फ़ील्ड
यूनियन फ़ील्ड dimension. वह डाइमेंशन और वैल्यू जिसके आधार पर प्रॉडक्ट का मिलान करना है. dimension इनमें से सिर्फ़ एक हो सकता है:
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 पहला मुख्य इंडेक्स.
CUSTOM_LABEL_KEY_2 बटन 2.
CUSTOM_LABEL_KEY_3 बटन 3.
CUSTOM_LABEL_KEY_4 बटन 4.

AdGroupInventoryControl

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

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

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
फ़ील्ड
यूनियन फ़ील्ड inventory_controls. विज्ञापन ग्रुप के लिए इन्वेंट्री कंट्रोल. inventory_controls इनमें से सिर्फ़ एक हो सकता है:
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

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

get

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

list

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

patch

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