Method: customers.recommendations.apply

সংশ্লিষ্ট প্রয়োগ পরামিতিগুলির সাথে প্রদত্ত সুপারিশগুলি প্রয়োগ করে৷

নিক্ষিপ্ত ত্রুটির তালিকা: প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি ডেটাবেস ত্রুটি ক্ষেত্র ত্রুটি শিরোনাম ত্রুটি অভ্যন্তরীণ ত্রুটি মিউটেট ত্রুটি কোটা ত্রুটি সুপারিশ ত্রুটি অনুরোধ ত্রুটি UrlFieldError

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
customerId

string

প্রয়োজন। সুপারিশ সহ গ্রাহকের আইডি।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
ক্ষেত্র
operations[]

object ( ApplyRecommendationOperation )

প্রয়োজন। সুপারিশ প্রয়োগ করার জন্য অপারেশন তালিকা. যদি partialFailure=false সব সুপারিশ একই ধরনের হওয়া উচিত প্রতি অনুরোধে 100টি অপারেশনের সীমা আছে।

partialFailure

boolean

সত্য হলে, সফল অপারেশন করা হবে এবং অবৈধ অপারেশন ত্রুটি ফিরিয়ে দেবে। যদি মিথ্যা হয়, অপারেশনগুলি একটি লেনদেন হিসাবে পরিচালিত হবে যদি এবং শুধুমাত্র যদি সেগুলি বৈধ হয়৷ ডিফল্ট মিথ্যা.

প্রতিক্রিয়া শরীর

RecommendationService.ApplyRecommendation এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
ক্ষেত্র
results[]

object ( ApplyRecommendationResult )

সুপারিশ প্রয়োগ করার জন্য অপারেশনের ফলাফল।

partialFailureError

object ( Status )

আংশিক ব্যর্থতা মোডে অপারেশন ব্যর্থতার সাথে সম্পর্কিত ত্রুটি৷ শুধুমাত্র যখন আংশিক ব্যর্থতা = সত্য এবং সমস্ত ত্রুটিগুলি অপারেশনগুলির মধ্যে ঘটে তখনই ফেরত দেওয়া হয়৷ অপারেশনের বাইরে কোনো ত্রুটি দেখা দিলে (উদাহরণস্বরূপ, প্রমাণীকরণের ত্রুটি) আমরা RPC স্তরের ত্রুটি ফেরত দিই।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

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

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

RecommendationOperation প্রয়োগ করুন

একটি সুপারিশ প্রয়োগ করার জন্য অপারেশন সম্পর্কে তথ্য এবং এটি কাস্টমাইজ করার জন্য কোনো পরামিতি।

JSON প্রতিনিধিত্ব
{
  "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)
  }
  // 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 )

লক্ষ্য CPA অপ্ট-ইন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার জন্য ঐচ্ছিক পরামিতি।

targetRoasOptIn

object ( TargetRoasOptInParameters )

লক্ষ্য ROAS অপ্ট-ইন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার জন্য ঐচ্ছিক পরামিতি।

calloutExtension

object ( CalloutExtensionParameters )

কলআউট এক্সটেনশন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

callExtension

object ( CallExtensionParameters )

কল এক্সটেনশন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

moveUnusedBudget

object ( MoveUnusedBudgetParameters )

অব্যবহৃত বাজেট প্রস্তাবনা প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

responsiveSearchAd

object ( ResponsiveSearchAdParameters )

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

useBroadMatchKeyword

object ( UseBroadMatchKeywordParameters )

একটি ব্যবহার বিস্তৃত ম্যাচ কীওয়ার্ড সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

responsiveSearchAdAsset

object ( ResponsiveSearchAdAssetParameters )

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

responsiveSearchAdImproveAdStrength

object ( ResponsiveSearchAdImproveAdStrengthParameters )

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন প্রয়োগ করার সময় ব্যবহার করার পরামিতিগুলি বিজ্ঞাপনের শক্তির সুপারিশ উন্নত করে।

raiseTargetCpaBidTooLow

object ( RaiseTargetCpaBidTooLowParameters )

একটি বৃদ্ধি লক্ষ্য CPA বিড খুব কম সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি। আবেদনটি অ্যাসিঙ্ক্রোনাস এবং সংশ্লিষ্ট প্রচারাভিযানে বিজ্ঞাপন গোষ্ঠীর সংখ্যার উপর নির্ভর করে মিনিট সময় নিতে পারে।

forecastingSetTargetRoas

object ( ForecastingSetTargetRoasParameters )

একটি পূর্বাভাস সেট লক্ষ্য ROAS সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

calloutAsset

object ( CalloutAssetParameters )

কলআউট সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

callAsset

object ( CallAssetParameters )

কল সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

raiseTargetCpa

object ( RaiseTargetCpaParameters )

টার্গেট CPA সুপারিশ বাড়াতে আবেদন করার সময় ব্যবহার করার পরামিতি।

lowerTargetRoas

object ( LowerTargetRoasParameters )

নিম্ন লক্ষ্য ROAS সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

ক্যাম্পেইন বাজেট প্যারামিটার

প্রচারাভিযানের বাজেট সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "newBudgetAmountMicros": string
}
ক্ষেত্র
newBudgetAmountMicros

string ( int64 format)

লক্ষ্য বাজেট সংস্থানের জন্য সেট করা নতুন বাজেটের পরিমাণ। এটি একটি প্রয়োজনীয় ক্ষেত্র।

TextAd প্যারামিটার

একটি টেক্সট বিজ্ঞাপন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "ad": {
    object (Ad)
  }
}
ক্ষেত্র
ad

object ( Ad )

প্রস্তাবিত বিজ্ঞাপন গোষ্ঠীতে যোগ করার জন্য নতুন বিজ্ঞাপন। এই বার্তায় সমস্ত প্রয়োজনীয় ক্ষেত্র সেট করা দরকার। এটি একটি প্রয়োজনীয় ক্ষেত্র।

কীওয়ার্ড প্যারামিটার

কীওয়ার্ড সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
ক্ষেত্র
matchType

enum ( KeywordMatchType )

কীওয়ার্ডের মিলের ধরন। এটি একটি প্রয়োজনীয় ক্ষেত্র।

adGroup

string

কীওয়ার্ড যোগ করার জন্য বিজ্ঞাপন গোষ্ঠীর সংস্থান। এটি একটি প্রয়োজনীয় ক্ষেত্র।

cpcBidMicros

string ( int64 format)

ঐচ্ছিক, কীওয়ার্ডের জন্য সেট করার জন্য CPC বিড। যদি সেট না করা হয়, কীওয়ার্ড টার্গেট বিজ্ঞাপন গ্রুপ দ্বারা ব্যবহৃত বিডিং কৌশলের উপর ভিত্তি করে বিড ব্যবহার করবে।

TargetCpaOptInParameters

লক্ষ্য CPA সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
ক্ষেত্র
targetCpaMicros

string ( int64 format)

লক্ষ্য CPA বিডিং কৌশলের জন্য ব্যবহার করার জন্য গড় CPA। এটি একটি প্রয়োজনীয় ক্ষেত্র।

newCampaignBudgetAmountMicros

string ( int64 format)

ঐচ্ছিক, প্রচারের জন্য বাজেটের পরিমাণ সেট করতে হবে।

TargetRoasOptInParameters

টার্গেট ROAS অপ্ট-ইন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
ক্ষেত্র
targetRoas

number

টার্গেট ROAS বিডিং কৌশলের জন্য ব্যবহার করার জন্য গড় ROAS (ব্যয়ের প্রতি ইউনিট আয়)। মান 0.01 এবং 1000.0 এর মধ্যে, অন্তর্ভুক্ত। এটি একটি প্রয়োজনীয় ক্ষেত্র, যদি না newCampaignBudgetAmountMicros সেট করা হয়।

newCampaignBudgetAmountMicros

string ( int64 format)

ঐচ্ছিক, প্রচারের জন্য বাজেটের পরিমাণ সেট করতে হবে।

কলআউট এক্সটেনশন প্যারামিটার

কলআউট এক্সটেনশন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
ক্ষেত্র
calloutExtensions[]

object ( CalloutFeedItem )

কলআউট এক্সটেনশন যোগ করা হবে. এটি একটি প্রয়োজনীয় ক্ষেত্র।

কল এক্সটেনশন প্যারামিটার

কল এক্সটেনশন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
ক্ষেত্র
callExtensions[]

object ( CallFeedItem )

কল এক্সটেনশন যোগ করা হবে. এটি একটি প্রয়োজনীয় ক্ষেত্র।

সাইটলিঙ্ক এক্সটেনশন প্যারামিটার

সাইটলিংক সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
ক্ষেত্র

MoveUusedBudget Parameters

অব্যবহৃত বাজেট প্রস্তাবনা প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "budgetMicrosToMove": string
}
ক্ষেত্র
budgetMicrosToMove

string ( int64 format)

অতিরিক্ত বাজেট থেকে সীমাবদ্ধ বাজেটে যাওয়ার জন্য বাজেটের পরিমাণ। এটি একটি প্রয়োজনীয় ক্ষেত্র।

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন প্যারামিটার

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "ad": {
    object (Ad)
  }
}
ক্ষেত্র
ad

object ( Ad )

প্রয়োজন। প্রস্তাবিত বিজ্ঞাপন গোষ্ঠীতে যোগ করার জন্য নতুন বিজ্ঞাপন।

ব্রডম্যাচ কীওয়ার্ড প্যারামিটার ব্যবহার করুন

একটি ব্যবহার বিস্তৃত ম্যাচ কীওয়ার্ড সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "newBudgetAmountMicros": string
}
ক্ষেত্র
newBudgetAmountMicros

string ( int64 format)

লক্ষ্য বাজেট সংস্থানের জন্য সেট করা নতুন বাজেটের পরিমাণ।

প্রতিক্রিয়াশীল অনুসন্ধান এ্যাসেট প্যারামিটার

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "updatedAd": {
    object (Ad)
  }
}
ক্ষেত্র
updatedAd

object ( Ad )

আপডেট করা বিজ্ঞাপন। বর্তমান বিজ্ঞাপনের বিষয়বস্তু প্রতিস্থাপন করা হবে।

রেসপনসিভ সার্চ অ্যাড ইমপ্রুভ অ্যাডস্ট্রেংথ প্যারামিটার

প্রতিক্রিয়াশীল অনুসন্ধান বিজ্ঞাপন প্রয়োগ করার সময় ব্যবহার করার পরামিতিগুলি বিজ্ঞাপনের শক্তির সুপারিশ উন্নত করে।

JSON প্রতিনিধিত্ব
{
  "updatedAd": {
    object (Ad)
  }
}
ক্ষেত্র
updatedAd

object ( Ad )

আপডেট করা বিজ্ঞাপন। বর্তমান বিজ্ঞাপনের বিষয়বস্তু প্রতিস্থাপন করা হবে।

RaiseTargetCpaBidTooLow প্যারামিটার

একটি বৃদ্ধি লক্ষ্য CPA বিড খুব কম সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি। আবেদনটি অ্যাসিঙ্ক্রোনাস এবং সংশ্লিষ্ট প্রচারে বিজ্ঞাপন গোষ্ঠীর সংখ্যার উপর নির্ভর করে মিনিট সময় নিতে পারে।

JSON প্রতিনিধিত্ব
{
  "targetMultiplier": number
}
ক্ষেত্র
targetMultiplier

number

প্রয়োজন। 1.0-এর চেয়ে বড় একটি সংখ্যা যে ফ্যাক্টরটি নির্দেশ করে যেটি দ্বারা লক্ষ্য CPA বৃদ্ধি করা হয়। এটি একটি প্রয়োজনীয় ক্ষেত্র।

ForecastingSetTargetRoasParameters

একটি পূর্বাভাস সেট লক্ষ্য roas সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
ক্ষেত্র
targetRoas

number

নতুন লক্ষ্য ROAS (ব্যয় প্রতি ইউনিট আয়) একটি প্রচারাভিযান সংস্থান সেট করার জন্য। মান 0.01 এবং 1000.0 এর মধ্যে, অন্তর্ভুক্ত।

campaignBudgetAmountMicros

string ( int64 format)

একটি প্রচারাভিযান সম্পদের জন্য সেট করার জন্য নতুন প্রচারাভিযানের বাজেটের পরিমাণ।

CalloutAssetParameters

কলআউট সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
ক্ষেত্র
adAssetApplyParameters

object ( AdAssetApplyParameters )

প্রয়োজন। কলআউট সম্পদ যোগ করা হবে. এটি একটি প্রয়োজনীয় ক্ষেত্র।

AdAssetApplyParameters

বিজ্ঞাপন সম্পদের সুপারিশ প্রয়োগ করার সময় ব্যবহৃত সাধারণ প্যারামিটার।

JSON প্রতিনিধিত্ব
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
ক্ষেত্র
newAssets[]

object ( Asset )

একটি সুযোগ তৈরি এবং সংযুক্ত করার জন্য সম্পদ। এটি একই কলে বিদ্যমান সম্পদের সাথে মিলিত হতে পারে।

existingAssets[]

string

একটি সুযোগের সাথে সংযুক্ত করার জন্য বিদ্যমান সম্পদের সম্পদের নাম। এটি একই কলে নতুন সম্পদের সাথে মিলিত হতে পারে।

scope

enum ( ApplyScope )

প্রয়োজন। সম্পদ প্রয়োগ করার সুযোগ। প্রচারের সুযোগ স্তরের সম্পদ সুপারিশের সাথে যুক্ত প্রচারাভিযানে প্রয়োগ করা হবে। গ্রাহক সুযোগে সম্পদ সমগ্র অ্যাকাউন্টে প্রযোজ্য হবে। প্রচারাভিযানের সুযোগে থাকা সম্পদ গ্রাহকের সুযোগে সংযুক্ত যেকোনও ওভাররাইড করবে।

ApplyScope

সম্পদ প্রয়োগ করার সুযোগ.

এনামস
UNSPECIFIED আবেদনের সুযোগ নির্দিষ্ট করা হয়নি।
UNKNOWN অজানা।
CUSTOMER গ্রাহক সুযোগে আবেদন করুন।
CAMPAIGN প্রচারের সুযোগে আবেদন করুন।

কল অ্যাসেট প্যারামিটার

কল সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
ক্ষেত্র
adAssetApplyParameters

object ( AdAssetApplyParameters )

প্রয়োজন। কল সম্পদ যোগ করা হবে. এটি একটি প্রয়োজনীয় ক্ষেত্র।

SitelinkAssetParameters

সাইটলিঙ্ক সম্পদ সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
ক্ষেত্র
adAssetApplyParameters

object ( AdAssetApplyParameters )

প্রয়োজন। সাইটলিঙ্ক সম্পদ যোগ করা হবে. এটি একটি প্রয়োজনীয় ক্ষেত্র।

RaiseTargetCpaParameters

টার্গেট CPA সুপারিশ বাড়াতে প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "targetCpaMultiplier": number
}
ক্ষেত্র
targetCpaMultiplier

number

প্রয়োজন। সিপিএ গুণক সেট করার লক্ষ্য। এটি একটি প্রয়োজনীয় ক্ষেত্র।

LowerTargetRoas প্যারামিটার

নিম্ন লক্ষ্য ROAS সুপারিশ প্রয়োগ করার সময় ব্যবহার করার পরামিতি।

JSON প্রতিনিধিত্ব
{
  "targetRoasMultiplier": number
}
ক্ষেত্র
targetRoasMultiplier

number

প্রয়োজন। ROAS গুণক সেট করার লক্ষ্য। এটি একটি প্রয়োজনীয় ক্ষেত্র।

Recommendation Result প্রয়োগ করুন

একটি সুপারিশ প্রয়োগের ফলাফল.

JSON প্রতিনিধিত্ব
{
  "resourceName": string
}
ক্ষেত্র
resourceName

string

সফল প্রযোজ্য জন্য ফিরে.