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

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

AdGroup

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

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

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

जेएसओएन के काेड में दिखाना
{ "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`) ], "primaryStatus": enum (`AdGroupPrimaryStatus`), "primaryStatusReasons": [ enum (`AdGroupPrimaryStatusReason`) ], "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)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "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, और statIC_LOCATION_GROUP) चाइल्ड टाइप के तौर पर सेट है. इसलिए, अगर इस फ़ील्ड के लिएLOCATION_SYNC को सेट किया गया है, तो सभी लोकेशन ग्रुप के ऐसेट सेट को इस विज्ञापन ग्रुप से लिंक करने की अनुमति नहीं होगी. साथ ही, इस विज्ञापन ग्रुप में सभी लोकेशन एक्सटेंशन (LE) और अफ़िलिएट लोकेशन एक्सटेंशन (ALE) नहीं दिखेंगे. वर्तमान में केवलLOCATION_SYNC समर्थित है.
`primaryStatus`	`enum (AdGroupPrimaryStatus)` सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि कोई विज्ञापन ग्रुप सही तरीके से काम क्यों नहीं कर रहा है या सही तरीके से काम क्यों नहीं कर रहा है.
`primaryStatusReasons[]`	`enum (AdGroupPrimaryStatusReason)` सिर्फ़ आउटपुट के लिए. यह बताता है कि कोई विज्ञापन ग्रुप, सही से क्यों नहीं दिख रहा है या ठीक से काम नहीं कर रहा है.
`id`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. विज्ञापन ग्रुप का आईडी.
`name`	`string` विज्ञापन समूह का नाम. नए विज्ञापन ग्रुप बनाते समय यह फ़ील्ड ज़रूरी है और इसे खाली नहीं छोड़ा जा सकता. इसमें पूरी चौड़ाई वाले वर्णों की संख्या, 255 UTF-8 से कम होनी चाहिए. इसमें कोई भी शून्य (कोड पॉइंट 0x0), एनएल लाइन फ़ीड (कोड पॉइंट 0xA) या नई लाइन शुरू करने का निशान (कोड पॉइंट 0xD) नहीं होना चाहिए.
`baseAdGroup`	`string` सिर्फ़ आउटपुट के लिए. ड्राफ़्ट या टेस्ट विज्ञापन ग्रुप के लिए, यह फ़ील्ड उस बेस विज्ञापन ग्रुप के संसाधन का नाम है जिससे यह विज्ञापन ग्रुप बनाया गया था. अगर किसी ड्राफ़्ट या प्रयोग वाले विज्ञापन ग्रुप में, बेस विज्ञापन ग्रुप नहीं है, तो यह फ़ील्ड खाली होता है. बेस विज्ञापन ग्रुप के लिए, यह फ़ील्ड विज्ञापन ग्रुप के संसाधन नाम के बराबर होता है. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
`trackingUrlTemplate`	`string` ट्रैकिंग यूआरएल बनाने के लिए यूआरएल टेंप्लेट.
`campaign`	`string` इम्यूटेबल. वह कैंपेन जिससे विज्ञापन ग्रुप जुड़ा है.
`cpcBidMicros`	`string (int64 format)` ज़्यादा से ज़्यादा सीपीसी (हर क्लिक की लागत) बोली.
`effectiveCpcBidMicros`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. जब बोली लगाने की रणनीति मैन्युअल सीपीसी, बेहतर सीपीसी, पहले पेज के प्रचार या टारगेट आउटरैंक शेयर में से एक हो, तो मान सीपीसी (हर क्लिक की लागत) बोली के मान के बराबर होगा, नहीं तो मान शून्य होगा.
`cpmBidMicros`	`string (int64 format)` ज़्यादा से ज़्यादा सीपीएम (हर हज़ार इंप्रेशन की लागत) बोली.
`targetCpaMicros`	`string (int64 format)` टारगेट सीपीए (हर ग्राहक जोड़ने की लागत). अगर विज्ञापन ग्रुप के कैंपेन की बिडिंग की रणनीति, TargetCpa या कन्वर्ज़न बढ़ाएं (अपने targetCpa फ़ील्ड सेट के साथ) है, तो यह फ़ील्ड, कैंपेन की बिडिंग की रणनीति में तय किए गए टारगेट सीपीए को बदल देता है. ऐसा न होने पर, इस वैल्यू को अनदेखा कर दिया जाता है.
`cpvBidMicros`	`string (int64 format)` सीपीवी (हर व्यू की लागत) बिड.
`targetCpmMicros`	`string (int64 format)` माइक्रो में वह औसत रकम जिसे विज्ञापन देने वाला, हर हज़ार बार विज्ञापन दिखाने के लिए चुकाता है.
`targetRoas`	`number` टारगेट आरओएएस (विज्ञापन खर्च पर रिटर्न) को बदलता है. अगर विज्ञापन ग्रुप के कैंपेन की बिडिंग की रणनीति, TargetRoas या मैक्सिमम कन्वर्ज़न वैल्यू है (इसके targetRoas फ़ील्ड सेट के साथ) है, तो यह फ़ील्ड, कैंपेन की बिडिंग की रणनीति में दिए गए टारगेट आरओएएस को बदल देता है. ऐसा न होने पर, इस वैल्यू को अनदेखा कर दिया जाता है.
`percentCpcBidMicros`	`string (int64 format)` सीपीसी बिड की रकम का प्रतिशत, जिसे किसी सामान या सेवा के लिए, विज्ञापन में दिखाई गई कीमत के हिस्से के रूप में दिखाया जाता है. भिन्न के लिए मान्य रेंज [0,1) है और यहां स्टोर की गई वैल्यू 10,00,000 * [fraction] है.
`finalUrlSuffix`	`string` फ़ाइनल यूआरएल में पैरामीटर जोड़ने के लिए यूआरएल टेंप्लेट.
`effectiveTargetCpaMicros`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. प्रभावी टारगेट सीपीए (हर ग्राहक जोड़ने की लागत). इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
`effectiveTargetRoas`	`number` सिर्फ़ आउटपुट के लिए. असरदार टारगेट आरओएएस (विज्ञापन खर्च पर रिटर्न). इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.

AdGroupStatus

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

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

AdGroupAdRotationMode

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

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

AudienceSetting

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

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

फ़ील्ड

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

useAudienceGrouped

boolean

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

AdGroupPrimaryStatus

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

Enums
`UNSPECIFIED`	जानकारी नहीं है.
`UNKNOWN`	इसका इस्तेमाल सिर्फ़ रिटर्न वैल्यू के लिए किया जाता है. इस वर्शन में ऐसी वैल्यू दिखाता है जिसकी जानकारी नहीं है.
`ELIGIBLE`	विज्ञापन ग्रुप को दिखाया जा सकता है.
`PAUSED`	विज्ञापन ग्रुप रोका गया है.
`REMOVED`	विज्ञापन ग्रुप हटा दिया गया है.
`PENDING`	आने वाले समय में यह विज्ञापन ग्रुप दिखाया जा सकता है.
`NOT_ELIGIBLE`	विज्ञापन ग्रुप दिखाए जाने लायक नहीं है.
`LIMITED`	विज्ञापन ग्रुप, सीमित तौर पर दिखाया जा सकता है.

AdGroupPrimaryStatusReason

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

Enums
`UNSPECIFIED`	जानकारी नहीं है.
`UNKNOWN`	इसका इस्तेमाल सिर्फ़ रिटर्न वैल्यू के लिए किया जाता है. इस वर्शन में ऐसी वैल्यू दिखाता है जिसकी जानकारी नहीं है.
`CAMPAIGN_REMOVED`	उपयोगकर्ता के हिसाब से तय किए गए कैंपेन का स्टेटस हटा दिया जाता है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`CAMPAIGN_PAUSED`	उपयोगकर्ता के तय किए गए कैंपेन की स्थिति को रोक दिया गया है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`CAMPAIGN_PENDING`	इस कैंपेन के शुरू होने के लिए, उपयोगकर्ता का तय किया गया समय, आने वाले समय का है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`CAMPAIGN_ENDED`	इस कैंपेन के खत्म होने के लिए, उपयोगकर्ता का तय किया गया समय बीत चुका है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`AD_GROUP_PAUSED`	उपयोगकर्ता के हिसाब से तय किया गया विज्ञापन ग्रुप रोक दिया गया है. विज्ञापन समूह मूल स्थिति.PAUSE में योगदान करता है.
`AD_GROUP_REMOVED`	उपयोगकर्ता के हिसाब से तय की गई विज्ञापन ग्रुप स्थिति हटा दी जाती है. विज्ञापन समूह मूल स्थिति में योगदान करता है.REMOVED.
`AD_GROUP_INCOMPLETE`	इस विज्ञापन समूह का निर्माण अभी पूरा नहीं हुआ है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`KEYWORDS_PAUSED`	इस विज्ञापन ग्रुप में उपयोगकर्ता की तय की गई कीवर्ड स्थितियों को रोक दिया गया है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`NO_KEYWORDS`	इस विज्ञापन ग्रुप में ज़रूरी शर्तें पूरी करने वाला कोई कीवर्ड मौजूद नहीं है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`AD_GROUP_ADS_PAUSED`	इस विज्ञापन ग्रुप में, उपयोगकर्ता के हिसाब से तय किए गए विज्ञापन ग्रुप के सभी विज्ञापनों के स्टेटस को रोक दिया गया है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`NO_AD_GROUP_ADS`	इस विज्ञापन समूह में कोई योग्य विज्ञापन समूह विज्ञापन मौजूद नहीं है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`HAS_ADS_DISAPPROVED`	कम से कम एक विज्ञापन के अस्वीकार होने की वजह से, नीति की स्थिति की जानकारी. विज्ञापन ग्रुप के एक से ज़्यादा प्राइमरी स्टेटस में योगदान देता है.
`HAS_ADS_LIMITED_BY_POLICY`	नीति की वजह से कम से कम एक विज्ञापन के सीमित होने की वजह से, नीति की स्थिति की वजह. विज्ञापन ग्रुप के एक से ज़्यादा प्राइमरी स्टेटस में योगदान देता है.
`MOST_ADS_UNDER_REVIEW`	ज़्यादातर विज्ञापनों की समीक्षा होना बाकी होने की वजह से, नीति की स्थिति की जानकारी. विज्ञापन समूह मूल स्थिति.PENDING में योगदान देता है.
`CAMPAIGN_DRAFT`	विज्ञापन समूह एक ड्राफ़्ट अभियान से संबंधित है. विज्ञापन समूह मूल स्थिति में योगदान करता है.NOT_ELIGIBLE.
`AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY`	विज्ञापन ग्रुप लंबे समय तक काम नहीं कर रहा है, इसलिए उसे रोक दिया गया है. विज्ञापन समूह मूल स्थिति.PAUSE में योगदान करता है.