चेतावनी: आप एपीआई के REST इंटरफ़ेस के बारे में दस्तावेज़ देख रहे हैं. हमारी ज़्यादातर आधिकारिक क्लाइंट लाइब्रेरी, gRPC का इस्तेमाल करती हैं. ज़्यादा जानकारी के लिए, REST के बारे में जानकारी देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

AdGroup

JSON फ़ॉर्मैट में दिखाना
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- JSON फ़ॉर्मैट में दिखाना

विज्ञापन ग्रुप.

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

फ़ील्ड
`resourceName`	`string` इम्यूटेबल. विज्ञापन ग्रुप के संसाधन का नाम. विज्ञापन ग्रुप के रिसॉर्स नेम इस तरह के होते हैं: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` विज्ञापन ग्रुप की स्थिति.
`type`	`enum (AdGroupType)` इम्यूटेबल. विज्ञापन ग्रुप का टाइप.
`adRotationMode`	`enum (AdGroupAdRotationMode)` विज्ञापन ग्रुप का विज्ञापन रोटेशन मोड.
`urlCustomParameters[]`	`object (CustomParameter)` `trackingUrlTemplate`, `finalUrls` या `mobile_final_urls` में कस्टम पैरामीटर टैग की जगह इस्तेमाल करने के लिए इस्तेमाल की जाने वाली मैपिंग की सूची.
`optimizedTargetingEnabled`	`boolean` अगर ऑप्टिमाइज़ की गई टारगेटिंग चालू है, तो वैल्यू 'सही' होगी. ऑप्टिमाइज़ की गई टारगेटिंग, बड़ी ऑडियंस तक पहुंचने की सुविधा की जगह है.
`displayCustomBidDimension`	`enum (TargetingDimension)` विज्ञापन देने वालों को टारगेटिंग डाइमेंशन तय करने की सुविधा देता है, जिस पर सटीक बिड लगाई जाती हैं. यह सिर्फ़ उन कैंपेन के लिए लागू होता है जो खोज को नहीं, बल्कि डिसप्ले नेटवर्क को टारगेट करते हैं.
`targetingSetting`	`object (TargetingSetting)` टारगेटिंग से जुड़ी सुविधाओं के लिए सेटिंग.
`audienceSetting`	`object (AudienceSetting)` इम्यूटेबल. दर्शकों से जुड़ी सुविधाओं के लिए सेटिंग.
`effectiveTargetCpaSource`	`enum (BiddingSource)` सिर्फ़ आउटपुट के लिए. प्रभावी टारगेट सीपीए का स्रोत. यह फ़ील्ड रीड-ओनली मोड में है.
`effectiveTargetRoasSource`	`enum (BiddingSource)` सिर्फ़ आउटपुट के लिए. असरदार टारगेट आरओएएस का सोर्स. यह फ़ील्ड रीड-ओनली मोड में है.
`labels[]`	`string` सिर्फ़ आउटपुट के लिए. इस विज्ञापन ग्रुप से जुड़े लेबल के संसाधन नाम.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` वे एसेट फ़ील्ड टाइप जिन्हें इस विज्ञापन ग्रुप से बाहर रखना है. इस विज्ञापन ग्रुप में, इन फ़ील्ड टाइप वाले एसेट लिंक, ऊपर के लेवल से इनहेरिट नहीं किए जाएंगे.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` वे एसेट सेट टाइप जिन्हें इस विज्ञापन ग्रुप में शामिल नहीं किया जाना चाहिए. इस तरह के एसेट सेट के लिंक, ऊपर के लेवल से इस विज्ञापन ग्रुप से इनहेरिट नहीं किए जाएंगे. लोकेशन ग्रुप के टाइप (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, और STIC_LOCATION_GROUP) किस तरह के चाइल्ड सिस्टम हैं. इसलिए, अगर इस फ़ील्ड के लिएLOCATION_SYNC सेट किया गया है, तो सभी लोकेशन ग्रुप ऐसेट सेट को इस विज्ञापन ग्रुप से लिंक करने की अनुमति नहीं है. साथ ही, सभी लोकेशन एक्सटेंशन (LE) और अफ़िलिएट लोकेशन एक्सटेंशन (ALE) इस विज्ञापन ग्रुप में नहीं दिखाए जाएंगे. वर्तमान में केवलLOCATION_SYNC समर्थित है.
`id`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. विज्ञापन ग्रुप का आईडी.
`name`	`string` विज्ञापन समूह का नाम. नए विज्ञापन ग्रुप बनाते समय यह फ़ील्ड ज़रूरी है और खाली नहीं होना चाहिए. इसमें पूरी चौड़ाई वाले वर्ण, 255 UTF-8 से कम होने चाहिए. इसमें कोई शून्य (कोड पॉइंट 0x0), एनएल लाइन फ़ीड (कोड पॉइंट 0xA) या नई लाइन शुरू करने का चिह्न (कोड पॉइंट 0xD) नहीं होना चाहिए.
`baseAdGroup`	`string` सिर्फ़ आउटपुट के लिए. ड्राफ़्ट या प्रयोग वाले विज्ञापन ग्रुप के लिए, यह फ़ील्ड उस बेस विज्ञापन ग्रुप का संसाधन नाम है जिससे यह विज्ञापन ग्रुप बनाया गया था. अगर किसी ड्राफ़्ट या टेस्ट विज्ञापन ग्रुप में बेस विज्ञापन ग्रुप नहीं है, तो यह फ़ील्ड खाली होता है. बेस विज्ञापन ग्रुप के लिए, यह फ़ील्ड विज्ञापन ग्रुप के संसाधन नाम के बराबर होता है. यह फ़ील्ड रीड-ओनली मोड में है.
`trackingUrlTemplate`	`string` ट्रैकिंग यूआरएल बनाने के लिए यूआरएल टेंप्लेट.
`campaign`	`string` इम्यूटेबल. वह कैंपेन जिससे यह विज्ञापन ग्रुप जुड़ा है.
`cpcBidMicros`	`string (int64 format)` अधिकतम CPC (हर क्लिक की लागत) बोली.
`effectiveCpcBidMicros`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. जब बिडिंग की रणनीति मैन्युअल सीपीसी, बेहतर सीपीसी, पहले पेज पर प्रमोट किए गए या टारगेट आउटरैंक शेयर में से कोई एक हो, तो इसका वैल्यू सीपीसी (हर क्लिक की लागत) बिड की वैल्यू के बराबर होगा. ऐसा न होने पर, वैल्यू शून्य होगी.
`cpmBidMicros`	`string (int64 format)` ज़्यादा से ज़्यादा सीपीएम (हर हज़ार दिखने वाले इंप्रेशन की लागत) बोली.
`targetCpaMicros`	`string (int64 format)` टारगेट सीपीए (हर ग्राहक जोड़ने की लागत). अगर विज्ञापन ग्रुप के लिए, कैंपेन की बिडिंग की रणनीति TargetCpa या'कन्वर्ज़न बढ़ाएं' (अपने targetCpa फ़ील्ड सेट के साथ) है, तो यह फ़ील्ड, कैंपेन की बिडिंग की रणनीति में तय किए गए टारगेट सीपीए को बदल देती है. ऐसा न होने पर, इस वैल्यू को अनदेखा कर दिया जाता है.
`cpvBidMicros`	`string (int64 format)` CPV (हर व्यू की लागत) बोली.
`targetCpmMicros`	`string (int64 format)` माइक्रो में वह औसत रकम जिसे विज्ञापन देने वाला, विज्ञापन को एक हज़ार बार दिखाए जाने पर चुकाने के लिए तैयार है.
`targetRoas`	`number` टारगेट आरओएएस (विज्ञापन खर्च पर रिटर्न) ओवरराइड होता है. अगर विज्ञापन ग्रुप के लिए, कैंपेन की बिडिंग की रणनीति Targetroas या'कन्वर्ज़न वैल्यू बढ़ाएं' (अपने टारगेट आरओएएस फ़ील्ड सेट के साथ) है, तो यह फ़ील्ड कैंपेन की बिडिंग की रणनीति में तय किए गए टारगेट आरओएएस को बदल देता है. ऐसा न होने पर, इस वैल्यू को अनदेखा कर दिया जाता है.
`percentCpcBidMicros`	`string (int64 format)` सीपीसी बिड का प्रतिशत, जिसे कुछ प्रॉडक्ट या सेवा के लिए, विज्ञापन में दिखाई गई कीमत के हिस्से के तौर पर दिखाया जाता है. भिन्न के लिए मान्य श्रेणी [0,1) है और यहां संग्रहित मान 1,000,000 * [fraction] है.
`finalUrlSuffix`	`string` फ़ाइनल यूआरएल में पैरामीटर जोड़ने के लिए यूआरएल टेंप्लेट.
`effectiveTargetCpaMicros`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. प्रभावी टारगेट सीपीए (हर ग्राहक जोड़ने की लागत). यह फ़ील्ड रीड-ओनली मोड में है.
`effectiveTargetRoas`	`number` सिर्फ़ आउटपुट के लिए. असरदार टारगेट आरओएएस (विज्ञापन खर्च पर रिटर्न). यह फ़ील्ड रीड-ओनली मोड में है.

AdGroupStatus

किसी विज्ञापन ग्रुप की संभावित स्थितियां.

Enums
`UNSPECIFIED`	स्थिति के बारे में नहीं बताया गया है.
`UNKNOWN`	इस वर्शन में मिली वैल्यू की जानकारी नहीं है. यह सिर्फ़ रिस्पॉन्स वैल्यू है.
`ENABLED`	विज्ञापन ग्रुप चालू है.
`PAUSED`	विज्ञापन ग्रुप को रोका गया है.
`REMOVED`	विज्ञापन ग्रुप हटा दिया गया है.

AdGroupType

विज्ञापन ग्रुप के संभावित टाइप की सूची दिखाने वाली Enum.

Enums
`UNSPECIFIED`	टाइप के बारे में नहीं बताया गया है.
`UNKNOWN`	इस वर्शन में मिली वैल्यू की जानकारी नहीं है. यह सिर्फ़ रिस्पॉन्स वैल्यू है.
`SEARCH_STANDARD`	सर्च कैंपेन के लिए डिफ़ॉल्ट विज्ञापन ग्रुप टाइप.
`DISPLAY_STANDARD`	डिसप्ले कैंपेन के लिए डिफ़ॉल्ट विज्ञापन ग्रुप टाइप.
`SHOPPING_PRODUCT_ADS`	स्टैंडर्ड प्रॉडक्ट के विज्ञापन दिखाने वाले शॉपिंग कैंपेन के लिए विज्ञापन ग्रुप का टाइप.
`HOTEL_ADS`	होटल कैंपेन के लिए डिफ़ॉल्ट विज्ञापन ग्रुप टाइप.
`SHOPPING_SMART_ADS`	स्मार्ट शॉपिंग कैंपेन में विज्ञापन ग्रुप का टाइप.
`VIDEO_BUMPER`	छोटे इन-स्ट्रीम वीडियो विज्ञापन जिन्हें स्किप नहीं किया जा सकता.
`VIDEO_TRUE_VIEW_IN_STREAM`	TrueView (स्किप किए जा सकने वाले) इन-स्ट्रीम वीडियो विज्ञापन.
`VIDEO_TRUE_VIEW_IN_DISPLAY`	TrueView इन-डिस्प्ले वीडियो विज्ञापन.
`VIDEO_NON_SKIPPABLE_IN_STREAM`	स्किप न किए जा सकने वाले इन-स्ट्रीम वीडियो विज्ञापन.
`VIDEO_OUTSTREAM`	आउटस्ट्रीम वीडियो विज्ञापन.
`SEARCH_DYNAMIC_ADS`	डाइनैमिक सर्च विज्ञापनों के विज्ञापन ग्रुप के लिए विज्ञापन ग्रुप का टाइप.
`SHOPPING_COMPARISON_LISTING_ADS`	शॉपिंग तुलना लिस्टिंग कैंपेन में विज्ञापन ग्रुप का टाइप.
`PROMOTED_HOTEL_ADS`	प्रमोट किए गए होटल विज्ञापन ग्रुप के लिए विज्ञापन ग्रुप का टाइप.
`VIDEO_RESPONSIVE`	वीडियो रिस्पॉन्सिव विज्ञापन ग्रुप.
`VIDEO_EFFICIENT_REACH`	वीडियो के ज़रिए बेहतर पहुंच वाले विज्ञापन ग्रुप.
`SMART_CAMPAIGN_ADS`	स्मार्ट कैंपेन के लिए विज्ञापन ग्रुप का टाइप.
`TRAVEL_ADS`	ट्रैवल कैंपेन के लिए विज्ञापन ग्रुप का टाइप.

AdGroupAdRotationMode

किसी विज्ञापन ग्रुप के विज्ञापन रोटेशन के संभावित मोड.

Enums
`UNSPECIFIED`	विज्ञापन रोटेशन मोड की जानकारी नहीं दी गई है.
`UNKNOWN`	इस वर्शन में मिली वैल्यू की जानकारी नहीं है. यह सिर्फ़ रिस्पॉन्स वैल्यू है.
`OPTIMIZE`	क्लिक या कन्वर्ज़न के आधार पर, विज्ञापन ग्रुप के विज्ञापनों को ऑप्टिमाइज़ करें.
`ROTATE_FOREVER`	हमेशा के लिए समान रूप से रोटेट करें.

AudienceSetting

ऑडियंस टारगेटिंग की सेटिंग.

जेएसओएन के काेड में दिखाना
{ "useAudienceGrouped": boolean }

फ़ील्ड

फ़ील्ड
`useAudienceGrouped`	`boolean` इम्यूटेबल. सही होने पर, यह विज्ञापन ग्रुप, ऑडियंस टारगेटिंग के लिए ऑडियंस संसाधन का इस्तेमाल करता है. गलत होने पर, यह विज्ञापन ग्रुप इसके बजाय ऑडियंस सेगमेंट की शर्तों का इस्तेमाल कर सकता है.

useAudienceGrouped

boolean

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