تغيير العناصر

كما هو موضّح في دليل بنية واجهة برمجة التطبيقات، لكل مورد من المستوى الأعلى في Google Ads API خدمة مقابلة خاصة بنوع المورد تتيح تعديل مثيلات المورد.

سيستخدم هذا الدليل CampaignService لـ توضيح كيفية تعديل كائنات Campaign، ولكن تنطبق المفاهيم نفسها على جميع الخدمات الأخرى الخاصة بنوع المورد.

تغيير الكائنات

ستتضمّن كل خدمة خاصة بنوع المورد طريقة تغيير تقبل طلب تغيير. يتألّف هذا الطلب من:

• customerId
• مجموعة من العمليات
• إعداد لنوع محتوى الاستجابة يحدّد ما إذا كان يجب عرض المورد القابل للتغيير أو اسم المورد فقط بعد التغيير.

على سبيل المثال، تقبل طريقة MutateCampaigns في CampaignService طلب MutateCampaignsRequest يتألّف من:

• customerId
• مجموعة من كائنات CampaignOperation
• الحقل response_content_type الذي يشير إلى نوع الاستجابة المفضّل.

العمليات

يتيح لك كائن العملية، مثل CampaignOperation، تحديد الإجراء الذي تريد تنفيذه على مورد واحد من خلال ضبط الحقل operation. هذا الحقل هو حقل `oneof` يتألّف من السمات التالية التي يكون نوعها هو نوع المورد:

create

لإنشاء مثيل جديد للمورد

update

لتعديل المورد ليطابق سمات update

المورد. عند ضبط هذا الحقل، عليك أيضًا ضبط update_mask للعملية، ما يخبر Google Ads API بالسمات التي يجب تعديلها أثناء عملية التعديل. تحتوي كل مكتبة برامج على أداة مساعدة أو طريقة مساعدة ستنشئ لك update_mask، كما هو موضّح في مكتبات البرامج.

remove

لإزالة المورد

بما أنّ الحقل operation هو حقل oneof، لا يمكنك استخدام عملية واحدة لتعديل كائنات متعددة. على سبيل المثال، إذا أردت إنشاء حملة واحدة وإزالة حملة أخرى، أضِف مثيلَين من CampaignOperation إلى طلبك: أحدهما تم ضبط create فيه، والآخر تم ضبط remove فيه.

عمليات مجمعة

على الرغم من أنّ عملية واحدة يمكنها فقط إنشاء مورد واحد أو تعديله أو إزالته، يمكن أن يحتوي طلب تغيير واحد على عمليات متعددة. عليك دمج عملياتك في طلب تغيير واحد بدلاً من إرسال طلبات تغيير متعددة يحتوي كل منها على عملية واحدة.

على سبيل المثال، إذا أردت إنشاء عشر حملات، عليك إرسال MutateCampaignsRequest واحد يحتوي على عشرة كائنات CampaignOperation.

استجابات التغيير

تعتمد البيانات المعروضة في الاستجابة على البيانات التي تم إرسالها في الـ response_content_type لطلب التغيير. على سبيل المثال، إذا تم تحديد MUTABLE_RESOURCE، ستتضمّن الاستجابة الحقول القابلة للتغيير فقط في الحملة. يمكنك بعد ذلك إجراء عمليات تغيير لاحقة على كائن المورد هذا بدون الحاجة إلى إعادة إنشائه.

أخطاء التغيير

لن يتم تطبيق العمليات في طلب تغيير معيّن على حسابك على "إعلانات Google" إلا إذا نجحت كل عملية في الطلب. راجِع دليل الأخطاء الشائعة للاطّلاع على قائمة بالأخطاء الشائعة وكيفية حلّها.

تتبّع التغييرات

لتتبُّع التغييرات التي تم إجراؤها على الكائنات في حسابك على "إعلانات Google"، أو لاسترداد الحالة الحالية للكائنات، يمكنك استخدام الموردَين change_status وchange_event.

• change_status يقدّم ملخّصًا للموارد التي تم تغييرها خلال فترة زمنية معيّنة.
• change_event يقدّم سجلّاً مفصّلاً للتغييرات، بما في ذلك القيم القديمة والجديدة للحقول التي تم تغييرها.

للاستعلام عن هذه الموارد، استخدِم الطريقتَين GoogleAdsService.SearchStream أو GoogleAdsService.Search. مزيد من المعلومات حول بث التقارير باستخدام GoogleAdsService.