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