Method: customers.recommendations.apply

दिए गए सुझावों को उनसे जुड़े पैरामीटर के साथ लागू करता है.

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

एचटीटीपी अनुरोध

POST https://googleads.googleapis.com/v15/customers/{customerId}/recommendations:apply

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. सुझाव के साथ ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
फ़ील्ड
operations[]

object (ApplyRecommendationOperation)

ज़रूरी है. सुझावों को लागू करने के लिए कार्रवाइयों की सूची. अगर segmentFailure=false, सभी सुझाव एक ही तरह के होने चाहिए, तो हर अनुरोध में ज़्यादा से ज़्यादा 100 कार्रवाइयां की जा सकती हैं.
partialFailure

boolean

सही होने पर, सही कार्रवाइयां की जाएंगी और अमान्य ऑपरेशन से गड़बड़ियां दिखेंगी. गलत होने पर, लेन-देन के तौर पर सिर्फ़ तभी की जाएंगी, जब वे सभी मान्य हों. डिफ़ॉल्ट रूप से गलत पर सेट होती है.

जवाब का मुख्य भाग

RecommendationService.ApplyRecommendation के लिए जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
फ़ील्ड
results[]

object (ApplyRecommendationResult)

सुझावों को लागू करने के लिए की गई कार्रवाइयों के नतीजे.
partialFailureError

object (Status)

आंशिक फ़ेलियर मोड में कार्रवाई न हो पाने से जुड़ी गड़बड़ियां. सिर्फ़ तभी दिया जाता है, जबनैशनल फ़ंक्शन = true और सभी गड़बड़ियां ऑपरेशन में होती हैं. अगर ऑपरेशन के बाहर कोई गड़बड़ी होती है (उदाहरण के लिए, पुष्टि करने से जुड़ी गड़बड़ियां), तो हम RPC लेवल की गड़बड़ी दिखाते हैं.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/adwords

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

ApplyRecommendationOperation

सुझाव लागू करने की कार्रवाई और इसे पसंद के मुताबिक बनाने के लिए पैरामीटर की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  },
  "forecastingSetTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
फ़ील्ड
resourceName

string

लागू करने के लिए सुझाव के संसाधन का नाम.
यूनियन फ़ील्ड apply_parameters. सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. apply_parameters इनमें से सिर्फ़ एक हो सकता है:
campaignBudget

object (CampaignBudgetParameters)

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

object (TextAdParameters)

टेक्स्ट विज्ञापन सुझाव लागू करते समय इस्तेमाल करने के लिए वैकल्पिक पैरामीटर.
keyword

object (KeywordParameters)

कीवर्ड सुझाव लागू करते समय इस्तेमाल करने के लिए वैकल्पिक पैरामीटर.
targetCpaOptIn

object (TargetCpaOptInParameters)

टारगेट सीपीए ऑप्ट-इन सुझाव लागू करते समय इस्तेमाल करने के लिए वैकल्पिक पैरामीटर.
targetRoasOptIn

object (TargetRoasOptInParameters)

टारगेट आरओएएस ऑप्ट-इन सुझाव को लागू करते समय इस्तेमाल किए जाने वाले वैकल्पिक पैरामीटर.
calloutExtension

object (CalloutExtensionParameters)

कॉलआउट एक्सटेंशन का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
callExtension

object (CallExtensionParameters)

कॉल एक्सटेंशन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

इस्तेमाल नहीं किए गए बजट को किसी दूसरे खाते में ले जाने के सुझाव को लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

रिस्पॉन्सिव सर्च विज्ञापन के सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

ब्रॉड मैच में इस्तेमाल होने वाले कीवर्ड के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

रिस्पॉन्सिव सर्च विज्ञापन एसेट का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

रिस्पॉन्सिव सर्च विज्ञापन (सर्च क्वेरी के हिसाब से ढल जाने वाले विज्ञापन) को लागू करते समय, इस्तेमाल किए जाने वाले पैरामीटर. इससे 'विज्ञापन की खूबियां' मेट्रिक को बेहतर बनाने में मदद मिलती है.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

टारगेट सीपीए बोली बढ़ाने के लिए बहुत कम सुझाव लागू करने पर इस्तेमाल किए जाने वाले पैरामीटर. इसे लागू करने की प्रोसेस एसिंक्रोनस होती है. साथ ही, मिलते-जुलते कैंपेन में मौजूद विज्ञापन ग्रुप की संख्या के आधार पर, इसमें कुछ मिनट लग सकते हैं.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

अनुमान के सेट किए गए टारगेट आरओएएस के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
calloutAsset

object (CalloutAssetParameters)

कॉलआउट एसेट का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
callAsset

object (CallAssetParameters)

कॉल एसेट का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
raiseTargetCpa

object (RaiseTargetCpaParameters)

टारगेट सीपीए बढ़ाने के सुझाव को लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.
lowerTargetRoas

object (LowerTargetRoasParameters)

कम टारगेट आरओएएस के सुझाव को लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

सेट किए गए टारगेट सीपीए के अनुमान को लागू करने के लिए, इस्तेमाल किए जाने वाले पैरामीटर.
setTargetCpa

object (ForecastingSetTargetCpaParameters)

सेट किए गए टारगेट सीपीए के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
setTargetRoas

object (ForecastingSetTargetRoasParameters)

सेट किए गए टारगेट आरओएएस के सुझाव को लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.

CampaignBudgetParameters

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

जेएसओएन के काेड में दिखाना 
{
  "newBudgetAmountMicros": string
}
फ़ील्ड
newBudgetAmountMicros

string (int64 format)

टारगेट बजट संसाधन के लिए सेट की जाने वाली नई बजट रकम. यह अनिवार्य फ़ील्ड है.

TextAdParameters

टेक्स्ट विज्ञापन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "ad": {
    object (Ad)
  }
}
फ़ील्ड
ad

object (Ad)

सुझाए गए विज्ञापन ग्रुप में जोड़ने के लिए नया विज्ञापन. इस मैसेज में सभी ज़रूरी फ़ील्ड सेट किए जाने चाहिए. यह अनिवार्य फ़ील्ड है.

KeywordParameters

कीवर्ड सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
फ़ील्ड
matchType

enum (KeywordMatchType)

कीवर्ड का मैच टाइप. यह अनिवार्य फ़ील्ड है.
adGroup

string

विज्ञापन ग्रुप का वह संसाधन जिसमें कीवर्ड जोड़ना है. यह अनिवार्य फ़ील्ड है.
cpcBidMicros

string (int64 format)

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

TargetCpaOptInParameters

टारगेट सीपीए का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
फ़ील्ड
targetCpaMicros

string (int64 format)

टारगेट सीपीए बोली लगाने की रणनीति के लिए इस्तेमाल किया जाने वाला औसत सीपीए. यह अनिवार्य फ़ील्ड है.
newCampaignBudgetAmountMicros

string (int64 format)

कैंपेन के लिए सेट किए जाने वाले बजट की रकम, ज़रूरी नहीं है.

TargetRoasOptInParameters

टारगेट आरओएएस ऑप्ट-इन सुझाव को लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
फ़ील्ड
targetRoas

number

टारगेट आरओएएस बिडिंग की रणनीति का इस्तेमाल करने के लिए, औसत आरओएएस (खर्च की प्रति इकाई आय). वैल्यू 0.01 से 1000.0 के बीच है. जब तक newCampaignबजटAmountMicros सेट नहीं है, तब तक यह फ़ील्ड भरना ज़रूरी है.
newCampaignBudgetAmountMicros

string (int64 format)

कैंपेन के लिए सेट किए जाने वाले बजट की रकम, ज़रूरी नहीं है.

CalloutExtensionParameters

कॉलआउट एक्सटेंशन का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
फ़ील्ड
calloutExtensions[]

object (CalloutFeedItem)

कॉलआउट एक्सटेंशन जोड़े जाएंगे. यह अनिवार्य फ़ील्ड है.

CallExtensionParameters

कॉल एक्सटेंशन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
फ़ील्ड
callExtensions[]

object (CallFeedItem)

कॉल एक्सटेंशन जोड़े जाने हैं. यह अनिवार्य फ़ील्ड है.

SitelinkExtensionParameters

साइटलिंक के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
फ़ील्ड

MoveUnusedBudgetParameters

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

जेएसओएन के काेड में दिखाना 
{
  "budgetMicrosToMove": string
}
फ़ील्ड
budgetMicrosToMove

string (int64 format)

बजट की रकम, जिसे अतिरिक्त बजट से सीमित बजट में बदला जाना है. यह अनिवार्य फ़ील्ड है.

ResponsiveSearchAdParameters

रिस्पॉन्सिव सर्च विज्ञापन के सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "ad": {
    object (Ad)
  }
}
फ़ील्ड
ad

object (Ad)

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

UseBroadMatchKeywordParameters

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

जेएसओएन के काेड में दिखाना 
{
  "newBudgetAmountMicros": string
}
फ़ील्ड
newBudgetAmountMicros

string (int64 format)

टारगेट बजट संसाधन के लिए सेट की जाने वाली नई बजट रकम.

ResponsiveSearchAdAssetParameters

रिस्पॉन्सिव सर्च विज्ञापन एसेट का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "updatedAd": {
    object (Ad)
  }
}
फ़ील्ड
updatedAd

object (Ad)

अपडेट किया गया विज्ञापन. मौजूदा विज्ञापन का कॉन्टेंट बदल दिया जाएगा.

ResponsiveSearchAdImproveAdStrengthParameters

रिस्पॉन्सिव सर्च विज्ञापन (सर्च क्वेरी के हिसाब से ढल जाने वाले विज्ञापन) को लागू करते समय, इस्तेमाल किए जाने वाले पैरामीटर. इससे 'विज्ञापन की खूबियां' मेट्रिक को बेहतर बनाने में मदद मिलती है.

जेएसओएन के काेड में दिखाना 
{
  "updatedAd": {
    object (Ad)
  }
}
फ़ील्ड
updatedAd

object (Ad)

अपडेट किया गया विज्ञापन. मौजूदा विज्ञापन का कॉन्टेंट बदल दिया जाएगा.

RaiseTargetCpaBidTooLowParameters

टारगेट सीपीए बोली बढ़ाने के लिए बहुत कम सुझाव लागू करने पर इस्तेमाल किए जाने वाले पैरामीटर. इसे लागू करने की प्रोसेस एसिंक्रोनस होती है. इसमें, मिलते-जुलते कैंपेन में मौजूद विज्ञापन ग्रुप की संख्या के आधार पर कुछ मिनट लग सकते हैं..

जेएसओएन के काेड में दिखाना 
{
  "targetMultiplier": number
}
फ़ील्ड
targetMultiplier

number

ज़रूरी है. 1.0 से बड़ी संख्या, उस फ़ैक्टर को दिखाती है जिससे टारगेट सीपीए को बढ़ाना है. यह अनिवार्य फ़ील्ड है.

ForecastingSetTargetRoasParameters

अनुमान के सेट किए गए टारगेट आरओएएस को लागू करने के लिए, इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
फ़ील्ड
targetRoas

number

कैंपेन संसाधन के लिए सेट किया जाने वाला नया टारगेट आरओएएस (खर्च की प्रति इकाई आय). वैल्यू 0.01 से 1000.0 के बीच है.
campaignBudgetAmountMicros

string (int64 format)

कैंपेन संसाधन के लिए सेट करने के लिए, नए कैंपेन के बजट की रकम.

CalloutAssetParameters

कॉलआउट एसेट के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
फ़ील्ड
adAssetApplyParameters

object (AdAssetApplyParameters)

ज़रूरी है. कॉलआउट एसेट जोड़ी जाएंगी. यह अनिवार्य फ़ील्ड है.

AdAssetApplyParameters

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

जेएसओएन के काेड में दिखाना 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
फ़ील्ड
newAssets[]

object (Asset)

वे ऐसेट जिन्हें किसी स्कोप में बनाना और अटैच करना है. इसे एक ही कॉल में मौजूद मौजूदा एसेट के साथ जोड़ा जा सकता है.
existingAssets[]

string

किसी स्कोप से अटैच करने के लिए, मौजूदा एसेट के संसाधन नाम. एक ही कॉल में इसे newAssets के साथ जोड़ा जा सकता है.
scope

enum (ApplyScope)

ज़रूरी है. वह स्कोप जिस पर ऐसेट को लागू करना है. कैंपेन के स्कोप के लेवल पर मौजूद एसेट, सुझाव से जुड़े कैंपेन पर लागू होंगी. ग्राहक के दायरे वाली एसेट पूरे खाते पर लागू होंगी. कैंपेन के दायरे में शामिल एसेट, ग्राहक के स्कोप में अटैच की गई एसेट को बदल देंगी.

ApplyScope

ऐसेट को लागू करने का स्कोप.

Enums
UNSPECIFIED लागू करने का दायरा तय नहीं किया गया है.
UNKNOWN अज्ञात.
CUSTOMER ग्राहक के दायरे पर लागू करें.
CAMPAIGN कैंपेन के दायरे पर लागू करें.

CallAssetParameters

कॉल एसेट के सुझाव लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
फ़ील्ड
adAssetApplyParameters

object (AdAssetApplyParameters)

ज़रूरी है. कॉल एसेट जोड़नी हैं. यह अनिवार्य फ़ील्ड है.

SitelinkAssetParameters

साइटलिंक एसेट के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
फ़ील्ड
adAssetApplyParameters

object (AdAssetApplyParameters)

ज़रूरी है. साइटलिंक एसेट जोड़नी हैं. यह अनिवार्य फ़ील्ड है.

RaiseTargetCpaParameters

टारगेट सीपीए बढ़ाने के सुझाव लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "targetCpaMultiplier": number
}
फ़ील्ड
targetCpaMultiplier

number

ज़रूरी है. सीपीए मल्टीप्लायर सेट करने के लिए टारगेट. यह अनिवार्य फ़ील्ड है.

LowerTargetRoasParameters

कम टारगेट आरओएएस के सुझावों को लागू करने के लिए इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "targetRoasMultiplier": number
}
फ़ील्ड
targetRoasMultiplier

number

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

ForecastingSetTargetCpaParameters

सेट किए गए टारगेट सीपीए के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.

जेएसओएन के काेड में दिखाना 
{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}
फ़ील्ड
targetCpaMicros

string (int64 format)

टारगेट सीपीए बोली लगाने की रणनीति के लिए इस्तेमाल किया जाने वाला औसत सीपीए.
campaignBudgetAmountMicros

string (int64 format)

कैंपेन संसाधन के लिए सेट करने के लिए, नए कैंपेन के बजट की रकम.

ApplyRecommendationResult

सुझाव लागू करने का नतीजा.

जेएसओएन के काेड में दिखाना 
{
  "resourceName": string
}
फ़ील्ड
resourceName

string

सफल लागू के लिए लौटाया गया.