Method: customers.recommendations.apply

يطبِّق هذا الإعداد الاقتراحات المحدّدة مع مَعلمات التطبيق المقابلة.

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError 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)

مطلوبة. قائمة العمليات اللازمة لتطبيق الاقتراحات إذا كان جزئيةFailure=false يجب أن تكون جميع الاقتراحات من النوع نفسه، يكون هناك حد أقصى يبلغ 100 عملية لكل طلب.
partialFailure

boolean

في حال ضبط هذه السياسة على "صحيح"، سيتم تنفيذ عمليات ناجحة، وستعرض العمليات غير الصالحة أخطاء. وفي حال اختيار القيمة "خطأ"، سيتم تنفيذ العمليات كمعاملة فقط إذا كانت جميعها صالحة. القيمة التلقائية هي "خطأ".

نص الاستجابة

رسالة الرد على RecommendationService.ApplyRecommendation.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
الحقول
results[]

object (ApplyRecommendationResult)

نتائج العمليات لتطبيق الاقتراحات
partialFailureError

object (Status)

الأخطاء التي تتعلّق بحالات تعذُّر التشغيل في وضع الفشل الجزئي. يُعرَض فقط عندما تكون قيمة جزئية Failrelure = true وتكون جميع الأخطاء داخل العمليات. في حالة حدوث أي أخطاء خارج العمليات (على سبيل المثال، أخطاء المصادقة)، يتم عرض الخطأ على مستوى استدعاء إجراء عن بُعد (RPC).

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

ApplyRecommendationOperation

معلومات عن عملية تطبيق الاقتراح وأيّ مَعلمات لتخصيصه.

تمثيل 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)

مَعلمات اختيارية يمكن استخدامها عند تطبيق اقتراح تفعيل التكلفة المستهدفة للإجراء.
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)

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح أقل لعائد الإنفاق الإعلاني المستهدف

CampaignBudgetParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح ميزانية الحملة

تمثيل JSON 
{
  "newBudgetAmountMicros": string
}
الحقول
newBudgetAmountMicros

string (int64 format)

مبلغ ميزانية جديد سيتم تحديده لمورد الميزانية المستهدفة. هذا الحقل إلزامي.

TextAdParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح إعلان نصي

تمثيل JSON 
{
  "ad": {
    object (Ad)
  }
}
الحقول
ad

object (Ad)

إعلان جديد لإضافته إلى المجموعة الإعلانية المقترحة. يجب ضبط جميع الحقول اللازمة في هذه الرسالة. هذا الحقل إلزامي.

KeywordParameters

المَعلمات المطلوب استخدامها عند تطبيق اقتراح الكلمات الرئيسية

تمثيل JSON 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
الحقول
matchType

enum (KeywordMatchType)

نوع مطابقة الكلمة الرئيسية. هذا الحقل إلزامي.
adGroup

string

مورد المجموعة الإعلانية المطلوب إضافة كلمة رئيسية إليه. هذا الحقل إلزامي.
cpcBidMicros

string (int64 format)

عرض سعر نقرة اختياري للكلمة الرئيسية. وفي حال تركها بدون ضبط، ستستخدم الكلمة الرئيسية عرض السعر استنادًا إلى استراتيجية عروض الأسعار المستخدَمة في المجموعة الإعلانية المستهدفة.

TargetCpaOptInParameters

المَعلمات التي سيتم استخدامها عند تطبيق اقتراح "التكلفة المستهدفة للإجراء"

تمثيل JSON 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
الحقول
targetCpaMicros

string (int64 format)

متوسط تكلفة الإجراء الذي يتم استخدامه في استراتيجية عروض الأسعار المستهدفة للإجراء. هذا الحقل إلزامي.
newCampaignBudgetAmountMicros

string (int64 format)

مبلغ الميزانية المطلوب تحديده للحملة اختياري

TargetRoasOptInParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح تفعيل عائد الإنفاق الإعلاني المستهدف

تمثيل JSON 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
الحقول
targetRoas

number

متوسط عائد الإنفاق الإعلاني (الأرباح لكل وحدة إنفاق) المطلوب استخدامه في استراتيجية عروض أسعار "عائد الإنفاق الإعلاني المستهدف". وتتراوح القيمة بين 0.01 و1000.0 بشكلٍ شامل. وهذا الحقل مطلوب، ما لم يتم ضبط newCampaignBudgetAmountMicros.
newCampaignBudgetAmountMicros

string (int64 format)

مبلغ الميزانية المطلوب تحديده للحملة اختياري

CalloutExtensionParameters

المعلّمات المطلوب استخدامها عند تطبيق اقتراح إضافة وسائل الشرح.

تمثيل JSON 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
الحقول
calloutExtensions[]

object (CalloutFeedItem)

سيتم إدراج إضافات وسائل الشرح. هذا الحقل إلزامي.

CallExtensionParameters

المعلّمات التي يمكن استخدامها عند تطبيق اقتراح إضافة المكالمة.

تمثيل JSON 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
الحقول
callExtensions[]

object (CallFeedItem)

سيتم إدراج إضافات المكالمات. هذا الحقل إلزامي.

SitelinkExtensionParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح روابط أقسام الموقع

تمثيل JSON 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
الحقول

MoveUnusedBudgetParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح الميزانية غير المستخدَم للنقل

تمثيل JSON 
{
  "budgetMicrosToMove": string
}
الحقول
budgetMicrosToMove

string (int64 format)

مبلغ الميزانية المطلوب الانتقال من الميزانية الزائدة إلى الميزانية المحدودة هذا الحقل إلزامي.

ResponsiveSearchAdParameters

المَعلمات المطلوب استخدامها عند تطبيق مقترح إعلان متجاوب على شبكة البحث

تمثيل JSON 
{
  "ad": {
    object (Ad)
  }
}
الحقول
ad

object (Ad)

مطلوبة. إعلان جديد لإضافته إلى المجموعة الإعلانية المقترحة.

UseBroadMatchKeywordParameters

المَعلمات التي سيتم استخدامها عند تطبيق اقتراح استخدام الكلمة الرئيسية التي تستخدِم المطابقة التقريبية

تمثيل JSON 
{
  "newBudgetAmountMicros": string
}
الحقول
newBudgetAmountMicros

string (int64 format)

مبلغ ميزانية جديد سيتم تحديده لمورد الميزانية المستهدفة.

ResponsiveSearchAdAssetParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراح مادة عرض إعلان متجاوب على شبكة البحث

تمثيل JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
الحقول
updatedAd

object (Ad)

تم تعديل الإعلان. سيتم استبدال محتوى الإعلان الحالي.

ResponsiveSearchAdImproveAdStrengthParameters

المَعلمات التي يتم استخدامها عند تطبيق إعلان متجاوب على شبكة البحث تؤدّي إلى تحسين اقتراح قوة الإعلان

تمثيل JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
الحقول
updatedAd

object (Ad)

تم تعديل الإعلان. سيتم استبدال محتوى الإعلان الحالي.

RaiseTargetCpaBidTooLowParameters

المَعلمات التي يجب استخدامها عند تطبيق زيادة كبيرة جدًا في عرض السعر المستهدف للإجراء عملية التطبيق غير متزامنة ويمكن أن تستغرق دقائق حسب عدد المجموعات الإعلانية في الحملة ذات الصلة.

تمثيل JSON 
{
  "targetMultiplier": number
}
الحقول
targetMultiplier

number

مطلوبة. رقم أكبر من 1.0 يشير إلى العامل الذي يجب من خلاله زيادة التكلفة المستهدفة للإجراء. هذا الحقل إلزامي.

ForecastingSetTargetRoasParameters

المعلّمات التي يمكن استخدامها عند تطبيق اقتراح عائد الإنفاق الإعلاني المستهدف المحدّد للتوقعات.

تمثيل JSON 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
الحقول
targetRoas

number

عائد الإنفاق الإعلاني المستهدف الجديد (الأرباح لكل وحدة من وحدات الإنفاق) المطلوب إعداده لمورد الحملة. وتتراوح القيمة بين 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 تطبيق على نطاق الحملة.

CallAssetParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات مواد عرض المكالمات

تمثيل JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
الحقول
adAssetApplyParameters

object (AdAssetApplyParameters)

مطلوبة. ستتم إضافة مواد عرض المكالمات. هذا الحقل إلزامي.

SitelinkAssetParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات مواد عرض روابط أقسام الموقع

تمثيل JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
الحقول
adAssetApplyParameters

object (AdAssetApplyParameters)

مطلوبة. مواد عرض روابط أقسام الموقع التي ستتم إضافتها. هذا الحقل إلزامي.

RaiseTargetCpaParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات زيادة اقتراحات التكلفة المستهدفة للإجراء

تمثيل JSON 
{
  "targetCpaMultiplier": number
}
الحقول
targetCpaMultiplier

number

مطلوبة. الاستهداف لضبط مُضاعِف تكلفة الإجراء عليه. هذا الحقل إلزامي.

LowerTargetRoasParameters

المَعلمات التي يمكن استخدامها عند تطبيق اقتراحات أقلّ لعائد الإنفاق الإعلاني المستهدَف

تمثيل JSON 
{
  "targetRoasMultiplier": number
}
الحقول
targetRoasMultiplier

number

مطلوبة. الاستهداف لضبط مضاعِف عائد الإنفاق الإعلاني هذا الحقل إلزامي.

ApplyRecommendationResult

نتيجة تطبيق الاقتراح.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

يُعرَض في عمليات التطبيق الناجحة.