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)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
फ़ील्ड
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)

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

enum (AdSource)

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

object (CreativeAssignment)

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

यह फ़ील्ड सिर्फ़ तब असाइन किया जा सकता है, जब adSource AD_SOURCE_DV360_CREATIVE हो.

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 इन्वेंट्री के लिए ऑप्ट-इन किया गया है या नहीं.

AdSource

इस adGroup में मौजूद विज्ञापनों का सोर्स.

Enums
AD_SOURCE_UNSPECIFIED जानकारी नहीं दी गई है या मौजूद नहीं है. डिफ़ॉल्ट रूप से, सामान्य विज्ञापन सोर्स पर सेट होता है.
AD_SOURCE_DV360_CREATIVE DV360 क्रिएटिव से लिया गया.

CreativeAssignment

विज्ञापन ग्रुप को असाइन किए गए क्रिएटिव की जानकारी.

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

string (int64 format)

ज़रूरी है. विज्ञापन ग्रुप को असाइन किए गए Display & Video 360 क्रिएटिव का आईडी.

तरीके

bulkEditAssignedTargetingOptions

 एक साथ कई विज्ञापन ग्रुप के लिए, टारगेटिंग के विकल्पों में एक साथ बदलाव करना.

bulkListAssignedTargetingOptions

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

create

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

delete

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

get

 विज्ञापन ग्रुप की जानकारी फ़ेच करता है.

list

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

patch

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