- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- CustomInterestOperation
- MutateCustomInterestResult
- جرِّبه الآن
ينشئ اهتمامات مخصّصة أو يعدّلها. يتم عرض حالات العمليات.
قائمة الأخطاء المعروضة: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/customInterests:mutate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل الذي يجري تعديل اهتماماته المخصّصة. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"operations": [
{
object ( |
الحقول | |
---|---|
operations[] |
مطلوبة. قائمة العمليات المطلوب تنفيذها على الاهتمامات المخصّصة الفردية. |
validateOnly |
إذا كانت القيمة true، يتم التحقق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج. |
نص الاستجابة
رسالة رد لتغيير الاهتمامات المخصّصة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"results": [
{
object ( |
الحقول | |
---|---|
results[] |
جميع النتائج المتعلقة بالمتغير. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
CustomInterestOperation
عملية واحدة (إنشاء أو تعديل) في شريحة جمهور مخصّصة.
تمثيل JSON |
---|
{ "updateMask": string, // Union field |
الحقول | |
---|---|
updateMask |
قناع FieldMask الذي يحدد حقول الموارد التي يتم تعديلها في التحديث. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
حقل الاتحاد operation عملية التبديل. يمكن أن تكون السمة "operation " واحدة فقط مما يلي: |
|
create |
عملية الإنشاء: لا يُتوقع أن يكون هناك اسم مورد للاهتمامات المخصصة الجديدة. |
update |
عملية التحديث: من المتوقّع أن يكون للاهتمامات المخصّصة اسم مورد صالح. |
MutateCustomInterestResult
نتيجة تبديل الاهتمام المخصّص.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
تم إرجاعه لإجراء عمليات ناجحة. |