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