- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ApplyRecommendationOperation
- CampaignBudgetParameters
- TextAdParameters
- KeywordParameters
- TargetCpaOptInParameters
- TargetRoasOptInParameters
- CalloutExtensionParameters
- CallExtensionParameters
- SitelinkExtensionParameters
- MoveUnusedBudgetParameters
- ResponsiveSearchAdParameters
- UseBroadMatchKeywordParameters
- ResponsiveSearchAdAssetParameters
- ResponsiveSearchAdImproveAdStrengthParameters
- RaiseTargetCpaBidTooLowParameters
- ForecastingSetTargetRoasParameters
- CalloutAssetParameters
- AdAssetApplyParameters
- ApplyScope
- CallAssetParameters
- SitelinkAssetParameters
- RaiseTargetCpaParameters
- LowerTargetRoasParameters
- ForecastingSetTargetCpaParameters
- LeadFormAssetParameters
- ApplyRecommendationResult
- इसे आज़माएं!
दिए गए सुझावों को उनसे जुड़े पैरामीटर के साथ लागू करता है.
इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:apply
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
ज़रूरी है. सुझाव के साथ ग्राहक का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"operations": [
{
object ( |
फ़ील्ड | |
---|---|
operations[] |
ज़रूरी है. सुझावों को लागू करने वाली कार्रवाइयों की सूची. अगर firstFailure=false एक ही तरह के होने चाहिए. हर अनुरोध के लिए ज़्यादा से ज़्यादा 100 कार्रवाइयां की जा सकती हैं. |
partialFailure |
सही होने पर, सही तरीके से कार्रवाइयां की जाएंगी और अमान्य कार्रवाइयां करने पर गड़बड़ियां मिलेंगी. गलत होने पर, कार्रवाइयों को लेन-देन के तौर पर सिर्फ़ तब किया जाएगा, जब वे सभी मान्य हों. डिफ़ॉल्ट रूप से गलत पर सेट होती है. |
जवाब का मुख्य भाग
RecommendationService.ApplyRecommendation
के लिए जवाब मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "results": [ { object ( |
फ़ील्ड | |
---|---|
results[] |
सुझावों को लागू करने से जुड़ी कार्रवाइयों के नतीजे. |
partialFailureError |
ऐसी गड़बड़ियां जो आंशिक फ़ेलियर मोड में काम नहीं करने की वजह से होती हैं. यह सिर्फ़ तब दिखाया जाता है, जबनैशनल = true और सभी गड़बड़ियां ऑपरेशन के दौरान होती हैं. अगर ऑपरेशन के बाहर कोई गड़बड़ी होती है (उदाहरण के लिए, पुष्टि करने से जुड़ी गड़बड़ियां), तो हम RPC लेवल की गड़बड़ी दिखाते हैं. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ApplyRecommendationOperation
सुझाव लागू करने की कार्रवाई और इसे पसंद के मुताबिक बनाने के लिए पैरामीटर की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "resourceName": string, // Union field |
फ़ील्ड | |
---|---|
resourceName |
लागू करने के लिए सुझाव के संसाधन का नाम. |
यूनियन फ़ील्ड apply_parameters . सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. apply_parameters इनमें से सिर्फ़ एक हो सकती है: |
|
campaignBudget |
कैंपेन बजट सुझाव लागू करते समय इस्तेमाल करने के लिए वैकल्पिक पैरामीटर. |
textAd |
टेक्स्ट विज्ञापन सुझाव लागू करते समय इस्तेमाल करने के लिए वैकल्पिक पैरामीटर. |
keyword |
कीवर्ड सुझाव लागू करते समय इस्तेमाल किए जाने वाले वैकल्पिक पैरामीटर. |
targetCpaOptIn |
टारगेट सीपीए ऑप्ट-इन सुझाव लागू करते समय इस्तेमाल किए जाने वाले वैकल्पिक पैरामीटर. |
targetRoasOptIn |
टारगेट आरओएएस ऑप्ट-इन करने का सुझाव लागू करते समय इस्तेमाल किए जाने वाले वैकल्पिक पैरामीटर. |
calloutExtension |
कॉलआउट एक्सटेंशन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
callExtension |
कॉल एक्सटेंशन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
sitelinkExtension |
साइटलिंक के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
moveUnusedBudget |
इस्तेमाल नहीं किए गए बजट को किसी दूसरे खाते में ले जाने के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
responsiveSearchAd |
रिस्पॉन्सिव सर्च विज्ञापन के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
useBroadMatchKeyword |
ब्रॉड मैच वाले कीवर्ड का इस्तेमाल करने के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
responsiveSearchAdAsset |
रिस्पॉन्सिव सर्च विज्ञापन ऐसेट के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
responsiveSearchAdImproveAdStrength |
रिस्पॉन्सिव सर्च विज्ञापन को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर, 'विज्ञापन की क्वालिटी' के सुझाव को बेहतर बनाते हैं. |
raiseTargetCpaBidTooLow |
टारगेट सीपीए बोली बढ़ाने के लिए, बहुत कम सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. लागू करने की प्रोसेस एसिंक्रोनस होती है. साथ ही, मिलते-जुलते कैंपेन में मौजूद विज्ञापन ग्रुप की संख्या के आधार पर इसमें कुछ मिनट लग सकते हैं. |
forecastingSetTargetRoas |
अनुमान के लिए सेट किए गए टारगेट आरओएएस के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
calloutAsset |
कॉलआउट ऐसेट का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
callAsset |
कॉल एसेट के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
sitelinkAsset |
साइटलिंक ऐसेट के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
raiseTargetCpa |
टारगेट सीपीए बढ़ाने का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
lowerTargetRoas |
कम टारगेट आरओएएस के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
forecastingSetTargetCpa |
अनुमान सेट करने के लिए टारगेट सीपीए का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
setTargetCpa |
सेट किए गए टारगेट सीपीए का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
setTargetRoas |
सेट किए गए टारगेट आरओएएस के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
leadFormAsset |
लीड फ़ॉर्म एसेट के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. |
CampaignBudgetParameters
कैंपेन बजट सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "newBudgetAmountMicros": string } |
फ़ील्ड | |
---|---|
newBudgetAmountMicros |
टारगेट बजट संसाधन के लिए सेट की जाने वाली नई बजट रकम. यह एक ज़रूरी फ़ील्ड है. |
TextAdParameters
टेक्स्ट विज्ञापन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"ad": {
object ( |
फ़ील्ड | |
---|---|
ad |
सुझाए गए विज्ञापन ग्रुप में जोड़ने के लिए नया विज्ञापन. इस मैसेज में सभी ज़रूरी फ़ील्ड को सेट करना होगा. यह एक ज़रूरी फ़ील्ड है. |
KeywordParameters
कीवर्ड सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"matchType": enum ( |
फ़ील्ड | |
---|---|
matchType |
कीवर्ड का मैच टाइप. यह एक ज़रूरी फ़ील्ड है. |
adGroup |
विज्ञापन ग्रुप का वह संसाधन जिसमें कीवर्ड जोड़ना है. यह एक ज़रूरी फ़ील्ड है. |
cpcBidMicros |
ज़रूरी नहीं, कीवर्ड के लिए सेट की जाने वाली सीपीसी बिड. अगर यह नीति सेट नहीं है, तो कीवर्ड, टारगेट किए गए विज्ञापन ग्रुप की बोली लगाने की रणनीति के आधार पर बोली का इस्तेमाल करेगा. |
TargetCpaOptInParameters
टारगेट सीपीए सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
फ़ील्ड | |
---|---|
targetCpaMicros |
टारगेट सीपीए बोली लगाने की रणनीति के लिए इस्तेमाल के लिए औसत सीपीए. यह एक ज़रूरी फ़ील्ड है. |
newCampaignBudgetAmountMicros |
ज़रूरी नहीं, कैंपेन के लिए सेट किए जाने वाले बजट की रकम. |
TargetRoasOptInParameters
टारगेट आरओएएस ऑप्ट-इन करने का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
फ़ील्ड | |
---|---|
targetRoas |
टारगेट आरओएएस बिडिंग की रणनीति में इस्तेमाल करने के लिए, औसत आरओएएस (हर खर्च की इकाई के हिसाब से आय). वैल्यू, 0.01 से 1000.0 के बीच है. अगर newCampaignBudgetAmountMicros सेट नहीं है, तो यह ज़रूरी फ़ील्ड है. |
newCampaignBudgetAmountMicros |
ज़रूरी नहीं, कैंपेन के लिए सेट किए जाने वाले बजट की रकम. |
CalloutExtensionParameters
कॉलआउट एक्सटेंशन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"calloutExtensions": [
{
object ( |
फ़ील्ड | |
---|---|
calloutExtensions[] |
कॉलआउट एक्सटेंशन जोड़े जाने हैं. यह एक ज़रूरी फ़ील्ड है. |
CallExtensionParameters
कॉल एक्सटेंशन सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"callExtensions": [
{
object ( |
फ़ील्ड | |
---|---|
callExtensions[] |
कॉल एक्सटेंशन जोड़े जाने हैं. यह एक ज़रूरी फ़ील्ड है. |
SitelinkExtensionParameters
साइटलिंक के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"sitelinkExtensions": [
{
object ( |
फ़ील्ड | |
---|---|
sitelinkExtensions[] |
जोड़े जाने वाले साइटलिंक. यह एक ज़रूरी फ़ील्ड है. |
MoveUnusedBudgetParameters
इस्तेमाल नहीं किए गए बजट को किसी दूसरे खाते में ले जाने के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "budgetMicrosToMove": string } |
फ़ील्ड | |
---|---|
budgetMicrosToMove |
बजट की रकम, जिसे अतिरिक्त बजट से सीमित बजट में बदला जाना है. यह एक ज़रूरी फ़ील्ड है. |
ResponsiveSearchAdParameters
रिस्पॉन्सिव सर्च विज्ञापन के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"ad": {
object ( |
फ़ील्ड | |
---|---|
ad |
ज़रूरी है. सुझाए गए विज्ञापन ग्रुप में जोड़ने के लिए नया विज्ञापन. |
UseBroadMatchKeywordParameters
ब्रॉड मैच वाले कीवर्ड का इस्तेमाल करने के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "newBudgetAmountMicros": string } |
फ़ील्ड | |
---|---|
newBudgetAmountMicros |
टारगेट बजट संसाधन के लिए सेट की जाने वाली नई बजट रकम. |
ResponsiveSearchAdAssetParameters
रिस्पॉन्सिव सर्च विज्ञापन ऐसेट के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"updatedAd": {
object ( |
फ़ील्ड | |
---|---|
updatedAd |
अपडेट किया गया विज्ञापन. मौजूदा विज्ञापन का कॉन्टेंट बदल दिया जाएगा. |
ResponsiveSearchAdImproveAdStrengthParameters
रिस्पॉन्सिव सर्च विज्ञापन को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर, 'विज्ञापन की क्वालिटी' के सुझाव को बेहतर बनाते हैं.
जेएसओएन के काेड में दिखाना |
---|
{
"updatedAd": {
object ( |
फ़ील्ड | |
---|---|
updatedAd |
अपडेट किया गया विज्ञापन. मौजूदा विज्ञापन का कॉन्टेंट बदल दिया जाएगा. |
RaiseTargetCpaBidTooLowParameters
टारगेट सीपीए बोली बढ़ाने के लिए, बहुत कम सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर. लागू करने की प्रोसेस एसिंक्रोनस होती है. साथ ही, मिलते-जुलते कैंपेन में मौजूद विज्ञापन ग्रुप की संख्या के आधार पर इसमें कुछ मिनट लग सकते हैं..
जेएसओएन के काेड में दिखाना |
---|
{ "targetMultiplier": number } |
फ़ील्ड | |
---|---|
targetMultiplier |
ज़रूरी है. 1.0 से बड़ी संख्या, उस फ़ैक्टर को दिखाती है जिससे टारगेट सीपीए को बढ़ाना है. यह एक ज़रूरी फ़ील्ड है. |
ForecastingSetTargetRoasParameters
अनुमान लगाने के लिए टारगेट आरओएएस के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "targetRoas": number, "campaignBudgetAmountMicros": string } |
फ़ील्ड | |
---|---|
targetRoas |
कैंपेन संसाधन के लिए सेट किया जाने वाला नया टारगेट आरओएएस (खर्च की हर इकाई के हिसाब से आय). वैल्यू, 0.01 से 1000.0 के बीच है. |
campaignBudgetAmountMicros |
कैंपेन संसाधन के लिए सेट किए जाने वाले नए कैंपेन के बजट की रकम. |
CalloutAssetParameters
कॉलआउट ऐसेट के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"adAssetApplyParameters": {
object ( |
फ़ील्ड | |
---|---|
adAssetApplyParameters |
ज़रूरी है. कॉलआउट एसेट जोड़ी जानी हैं. यह एक ज़रूरी फ़ील्ड है. |
AdAssetApplyParameters
विज्ञापन एसेट के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले सामान्य पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "newAssets": [ { object ( |
फ़ील्ड | |
---|---|
newAssets[] |
वे ऐसेट जिन्हें आपको बनाना और किसी स्कोप में अटैच करना है. इसे एक ही कॉल में मौजूद एसेट के साथ जोड़ा जा सकता है. |
existingAssets[] |
किसी स्कोप में अटैच करने के लिए, मौजूदा एसेट के संसाधन नाम. एक ही कॉल में, इसे newAssets के साथ जोड़ा जा सकता है. |
scope |
ज़रूरी है. वह स्कोप जिस पर ऐसेट लागू करनी हैं. कैंपेन स्कोप लेवल पर मौजूद ऐसेट, सुझाव से जुड़े कैंपेन पर लागू होंगी. ग्राहक के स्कोप वाली ऐसेट पूरे खाते पर लागू होंगी. कैंपेन के स्कोप वाली ऐसेट, ग्राहक के स्कोप में अटैच की गई किसी भी ऐसेट को बदल देंगी. |
ApplyScope
ऐसेट को लागू करने का स्कोप.
Enums | |
---|---|
UNSPECIFIED |
लागू किए जाने वाले दायरे के बारे में नहीं बताया गया है. |
UNKNOWN |
अज्ञात. |
CUSTOMER |
ग्राहक के दायरे में लागू करें. |
CAMPAIGN |
कैंपेन के दायरे में लागू करें. |
CallAssetParameters
कॉल एसेट के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"adAssetApplyParameters": {
object ( |
फ़ील्ड | |
---|---|
adAssetApplyParameters |
ज़रूरी है. कॉल एसेट जोड़ी जानी हैं. यह एक ज़रूरी फ़ील्ड है. |
SitelinkAssetParameters
साइटलिंक ऐसेट के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"adAssetApplyParameters": {
object ( |
फ़ील्ड | |
---|---|
adAssetApplyParameters |
ज़रूरी है. साइटलिंक एसेट जोड़ी जाएंगी. यह एक ज़रूरी फ़ील्ड है. |
RaiseTargetCpaParameters
टारगेट सीपीए बढ़ाने के सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "targetCpaMultiplier": number } |
फ़ील्ड | |
---|---|
targetCpaMultiplier |
ज़रूरी है. सीपीए मल्टीप्लायर सेट करने के लिए टारगेट. यह एक ज़रूरी फ़ील्ड है. |
LowerTargetRoasParameters
कम टारगेट आरओएएस के सुझावों को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "targetRoasMultiplier": number } |
फ़ील्ड | |
---|---|
targetRoasMultiplier |
ज़रूरी है. आरओएएस के मल्टीप्लायर पर सेट करने के लिए टारगेट. यह एक ज़रूरी फ़ील्ड है. |
ForecastingSetTargetCpaParameters
सेट किए गए टारगेट सीपीए का सुझाव लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{ "targetCpaMicros": string, "campaignBudgetAmountMicros": string } |
फ़ील्ड | |
---|---|
targetCpaMicros |
टारगेट सीपीए बोली लगाने की रणनीति के लिए इस्तेमाल के लिए औसत सीपीए. |
campaignBudgetAmountMicros |
कैंपेन संसाधन के लिए सेट किए जाने वाले नए कैंपेन के बजट की रकम. |
LeadFormAssetParameters
लीड फ़ॉर्म एसेट के सुझाव को लागू करते समय इस्तेमाल किए जाने वाले पैरामीटर.
जेएसओएन के काेड में दिखाना |
---|
{
"adAssetApplyParameters": {
object ( |
फ़ील्ड | |
---|---|
adAssetApplyParameters |
ज़रूरी है. लीड फ़ॉर्म एसेट जोड़ी जानी हैं. यह एक ज़रूरी फ़ील्ड है. |
setSubmitLeadFormAssetCampaignGoal |
सही होने पर, "लीड फ़ॉर्म सबमिट करें" लक्ष्य, टारगेट कैंपेन पर सेट होगा. इस वजह से, विज्ञापन, लीड फ़ॉर्म वाले क्रिएटिव विज्ञापनों के तौर पर दिखाए जाएंगे. गलत होने पर, "लीड फ़ॉर्म सबमिट करें" लक्ष्य, कैंपेन पर सेट नहीं किया जाएगा और विज्ञापनों में लीड फ़ॉर्म एसेट शामिल होंगे. |
ApplyRecommendationResult
किसी सुझाव को लागू करने का नतीजा.
जेएसओएन के काेड में दिखाना |
---|
{ "resourceName": string } |
फ़ील्ड | |
---|---|
resourceName |
लागू होने के लिए वापस भेजा गया. |