- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ApplyRecommendationOperation
- CampaignBudgetParameters
- TextAdParameters
- KeywordParameters
- TargetCpaOptInParameters
- TargetRoasOptInParameters
- CalloutExtensionParameters
- CallExtensionParameters
- SitelinkExtensionParameters
- MoveUnusedBudgetParameters
- ResponsiveSearchAdParameters
- UseBroadMatchKeywordParameters
- ResponsiveSearchAdAssetParameters
- ResponsiveSearchAdImproveAdStrengthParameters
- RaiseTargetCpaBidTooLowParameters
- ForecastingSetTargetRoasParameters
- CalloutAssetParameters
- AdAssetApplyParameters
- ApplyScope
- CallAssetParameters
- SitelinkAssetParameters
- RaiseTargetCpaParameters
- LowerTargetRoasParameters
- ForecastingSetTargetCpaParameters
- ApplyRecommendationResult
- جرِّبه الآن
يطبِّق هذا الإعداد الاقتراحات المحدّدة مع مَعلمات التطبيق المقابلة.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/recommendations:apply
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل الذي يتضمّن الاقتراح. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"operations": [
{
object ( |
الحقول | |
---|---|
operations[] |
مطلوبة. قائمة العمليات اللازمة لتطبيق الاقتراحات إذا كان جزئيةFailure=false يجب أن تكون جميع الاقتراحات من النوع نفسه، يكون هناك حد أقصى يبلغ 100 عملية لكل طلب. |
partialFailure |
في حال ضبط هذه السياسة على "صحيح"، سيتم تنفيذ عمليات ناجحة، وستعرض العمليات غير الصالحة أخطاء. وفي حال اختيار القيمة "خطأ"، سيتم تنفيذ العمليات كمعاملة فقط إذا كانت جميعها صالحة. القيمة التلقائية هي "خطأ". |
نص الاستجابة
رسالة الرد على RecommendationService.ApplyRecommendation
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "results": [ { object ( |
الحقول | |
---|---|
results[] |
نتائج العمليات لتطبيق الاقتراحات |
partialFailureError |
الأخطاء التي تتعلّق بحالات تعذُّر التشغيل في وضع الفشل الجزئي. يُعرَض فقط عندما تكون قيمة جزئية Failrelure = true وتكون جميع الأخطاء داخل العمليات. في حالة حدوث أي أخطاء خارج العمليات (على سبيل المثال، أخطاء المصادقة)، يتم عرض الخطأ على مستوى استدعاء إجراء عن بُعد (RPC). |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
ApplyRecommendationOperation
معلومات عن عملية تطبيق الاقتراح وأيّ مَعلمات لتخصيصه.
تمثيل JSON |
---|
{ "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 |
المَعلمات التي يجب استخدامها عند تطبيق اقتراح عائد الإنفاق الإعلاني المستهدَف المحدّد |
CampaignBudgetParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراح ميزانية الحملة
تمثيل JSON |
---|
{ "newBudgetAmountMicros": string } |
الحقول | |
---|---|
newBudgetAmountMicros |
مبلغ ميزانية جديد سيتم تحديده لمورد الميزانية المستهدفة. هذا الحقل إلزامي. |
TextAdParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراح إعلان نصي
تمثيل JSON |
---|
{
"ad": {
object ( |
الحقول | |
---|---|
ad |
إعلان جديد لإضافته إلى المجموعة الإعلانية المقترحة. يجب ضبط جميع الحقول اللازمة في هذه الرسالة. هذا الحقل إلزامي. |
KeywordParameters
المَعلمات المطلوب استخدامها عند تطبيق اقتراح الكلمات الرئيسية
تمثيل JSON |
---|
{
"matchType": enum ( |
الحقول | |
---|---|
matchType |
نوع مطابقة الكلمة الرئيسية. هذا الحقل إلزامي. |
adGroup |
مورد المجموعة الإعلانية المطلوب إضافة كلمة رئيسية إليه. هذا الحقل إلزامي. |
cpcBidMicros |
عرض سعر نقرة اختياري للكلمة الرئيسية. وفي حال تركها بدون ضبط، ستستخدم الكلمة الرئيسية عرض السعر استنادًا إلى استراتيجية عروض الأسعار المستخدَمة في المجموعة الإعلانية المستهدفة. |
TargetCpaOptInParameters
المَعلمات التي سيتم استخدامها عند تطبيق اقتراح "التكلفة المستهدفة للإجراء"
تمثيل JSON |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
الحقول | |
---|---|
targetCpaMicros |
متوسط تكلفة الإجراء الذي يتم استخدامه في استراتيجية عروض الأسعار المستهدفة للإجراء. هذا الحقل إلزامي. |
newCampaignBudgetAmountMicros |
مبلغ الميزانية المطلوب تحديده للحملة اختياري |
TargetRoasOptInParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراح تفعيل عائد الإنفاق الإعلاني المستهدف
تمثيل JSON |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
الحقول | |
---|---|
targetRoas |
متوسط عائد الإنفاق الإعلاني (الأرباح لكل وحدة إنفاق) المطلوب استخدامه في استراتيجية عروض أسعار "عائد الإنفاق الإعلاني المستهدف". وتتراوح القيمة بين 0.01 و1000.0 بشكلٍ شامل. وهذا الحقل مطلوب، ما لم يتم ضبط newCampaignBudgetAmountMicros. |
newCampaignBudgetAmountMicros |
مبلغ الميزانية المطلوب تحديده للحملة اختياري |
CalloutExtensionParameters
المعلّمات المطلوب استخدامها عند تطبيق اقتراح إضافة وسائل الشرح.
تمثيل JSON |
---|
{
"calloutExtensions": [
{
object ( |
الحقول | |
---|---|
calloutExtensions[] |
سيتم إدراج إضافات وسائل الشرح. هذا الحقل إلزامي. |
CallExtensionParameters
المعلّمات التي يمكن استخدامها عند تطبيق اقتراح إضافة المكالمة.
تمثيل JSON |
---|
{
"callExtensions": [
{
object ( |
الحقول | |
---|---|
callExtensions[] |
سيتم إدراج إضافات المكالمات. هذا الحقل إلزامي. |
SitelinkExtensionParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراح روابط أقسام الموقع
تمثيل JSON |
---|
{
"sitelinkExtensions": [
{
object ( |
الحقول | |
---|---|
sitelinkExtensions[] |
روابط أقسام الموقع التي ستتم إضافتها. هذا الحقل إلزامي. |
MoveUnusedBudgetParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراح الميزانية غير المستخدَم للنقل
تمثيل JSON |
---|
{ "budgetMicrosToMove": string } |
الحقول | |
---|---|
budgetMicrosToMove |
مبلغ الميزانية المطلوب الانتقال من الميزانية الزائدة إلى الميزانية المحدودة هذا الحقل إلزامي. |
ResponsiveSearchAdParameters
المَعلمات المطلوب استخدامها عند تطبيق مقترح إعلان متجاوب على شبكة البحث
تمثيل JSON |
---|
{
"ad": {
object ( |
الحقول | |
---|---|
ad |
مطلوبة. إعلان جديد لإضافته إلى المجموعة الإعلانية المقترحة. |
UseBroadMatchKeywordParameters
المَعلمات التي سيتم استخدامها عند تطبيق اقتراح استخدام الكلمة الرئيسية التي تستخدِم المطابقة التقريبية
تمثيل JSON |
---|
{ "newBudgetAmountMicros": string } |
الحقول | |
---|---|
newBudgetAmountMicros |
مبلغ ميزانية جديد سيتم تحديده لمورد الميزانية المستهدفة. |
ResponsiveSearchAdAssetParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراح مادة عرض إعلان متجاوب على شبكة البحث
تمثيل JSON |
---|
{
"updatedAd": {
object ( |
الحقول | |
---|---|
updatedAd |
تم تعديل الإعلان. سيتم استبدال محتوى الإعلان الحالي. |
ResponsiveSearchAdImproveAdStrengthParameters
المَعلمات التي يتم استخدامها عند تطبيق إعلان متجاوب على شبكة البحث تؤدّي إلى تحسين اقتراح قوة الإعلان
تمثيل JSON |
---|
{
"updatedAd": {
object ( |
الحقول | |
---|---|
updatedAd |
تم تعديل الإعلان. سيتم استبدال محتوى الإعلان الحالي. |
RaiseTargetCpaBidTooLowParameters
المَعلمات التي يجب استخدامها عند تطبيق زيادة كبيرة جدًا في عرض السعر المستهدف للإجراء عملية التطبيق غير متزامنة ويمكن أن تستغرق دقائق حسب عدد المجموعات الإعلانية في الحملة ذات الصلة.
تمثيل JSON |
---|
{ "targetMultiplier": number } |
الحقول | |
---|---|
targetMultiplier |
مطلوبة. رقم أكبر من 1.0 يشير إلى العامل الذي يجب من خلاله زيادة التكلفة المستهدفة للإجراء. هذا الحقل إلزامي. |
ForecastingSetTargetRoasParameters
المعلّمات التي يمكن استخدامها عند تطبيق اقتراح عائد الإنفاق الإعلاني المستهدف المحدّد للتوقعات.
تمثيل JSON |
---|
{ "targetRoas": number, "campaignBudgetAmountMicros": string } |
الحقول | |
---|---|
targetRoas |
عائد الإنفاق الإعلاني المستهدف الجديد (الأرباح لكل وحدة من وحدات الإنفاق) المطلوب إعداده لمورد الحملة. وتتراوح القيمة بين 0.01 و1000.0 بشكلٍ شامل. |
campaignBudgetAmountMicros |
مبلغ ميزانية الحملة الجديد المطلوب إعداده لمورد الحملة |
CalloutAssetParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات مواد عرض وسائل الشرح
تمثيل JSON |
---|
{
"adAssetApplyParameters": {
object ( |
الحقول | |
---|---|
adAssetApplyParameters |
مطلوبة. ستتم إضافة مواد عرض وسائل الشرح. هذا الحقل إلزامي. |
AdAssetApplyParameters
المَعلمات الشائعة المستخدَمة عند تطبيق اقتراحات مواد عرض الإعلانات
تمثيل JSON |
---|
{ "newAssets": [ { object ( |
الحقول | |
---|---|
newAssets[] |
مواد العرض المطلوب إنشاؤها وإرفاقها بنطاق. قد يتم دمج هذا الاسم مع مواد العرض الحالية في المكالمة نفسها. |
existingAssets[] |
أسماء الموارد لمواد العرض الحالية المطلوب إرفاقها بنطاق معيّن. قد يتم دمج هذا الاسم مع مواد العرض الجديدة في المكالمة نفسها. |
scope |
مطلوبة. النطاق الذي سيتم تطبيق مواد العرض عليه. سيتم تطبيق مواد العرض على مستوى نطاق الحملة على الحملة المرتبطة بالاقتراح. ستنطبق الأصول في نطاق العميل على الحساب بالكامل. ستلغي مواد العرض على مستوى الحملة أي مواد عرض مرفقة على مستوى العميل. |
ApplyScope
النطاق الذي سيتم تطبيق مواد العرض عليه.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد نطاق التطبيق. |
UNKNOWN |
غير معروف. |
CUSTOMER |
تطبيق على نطاق العميل. |
CAMPAIGN |
تطبيق على نطاق الحملة. |
CallAssetParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات مواد عرض المكالمات
تمثيل JSON |
---|
{
"adAssetApplyParameters": {
object ( |
الحقول | |
---|---|
adAssetApplyParameters |
مطلوبة. ستتم إضافة مواد عرض المكالمات. هذا الحقل إلزامي. |
SitelinkAssetParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات مواد عرض روابط أقسام الموقع
تمثيل JSON |
---|
{
"adAssetApplyParameters": {
object ( |
الحقول | |
---|---|
adAssetApplyParameters |
مطلوبة. مواد عرض روابط أقسام الموقع التي ستتم إضافتها. هذا الحقل إلزامي. |
RaiseTargetCpaParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات زيادة اقتراحات التكلفة المستهدفة للإجراء
تمثيل JSON |
---|
{ "targetCpaMultiplier": number } |
الحقول | |
---|---|
targetCpaMultiplier |
مطلوبة. الاستهداف لضبط مُضاعِف تكلفة الإجراء عليه. هذا الحقل إلزامي. |
LowerTargetRoasParameters
المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات أقلّ لعائد الإنفاق الإعلاني المستهدَف
تمثيل JSON |
---|
{ "targetRoasMultiplier": number } |
الحقول | |
---|---|
targetRoasMultiplier |
مطلوبة. الاستهداف لضبط مضاعِف عائد الإنفاق الإعلاني هذا الحقل إلزامي. |
ForecastingSetTargetCpaParameters
المَعلمات المطلوب استخدامها عند تطبيق اقتراح محدّد للتكلفة المستهدَفة للإجراء
تمثيل JSON |
---|
{ "targetCpaMicros": string, "campaignBudgetAmountMicros": string } |
الحقول | |
---|---|
targetCpaMicros |
متوسط تكلفة الإجراء الذي يتم استخدامه في استراتيجية عروض الأسعار المستهدفة للإجراء. |
campaignBudgetAmountMicros |
مبلغ ميزانية الحملة الجديد المطلوب إعداده لمورد الحملة |
ApplyRecommendationResult
نتيجة تطبيق الاقتراح.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
يُعرَض في عمليات التطبيق الناجحة. |