كما ورد في دليل بنية واجهة برمجة التطبيقات، فإن كل مورد عالي المستوى في إعلانات Google API يشتمل على خدمة مناظرة لنوع المورد تتوافق مع:
- تعديل مثيلات المورد
- استرداد مثيل واحد من المورد لفحصه
سيستخدم هذا الدليل CampaignService لإثبات تعديل كائنات Campaign وفحصها، ولكن تنطبق المفاهيم نفسها على جميع الخدمات الأخرى الخاصة بنوع المورد.
تغيير العناصر
لكل خدمة خاصة بنوع المورد طريقة تبديل تقبل طلب التبديل. يتألف هذا الطلب من:
customerId- مجموعة من العمليات
- إعداد نوع محتوى الاستجابة الذي يحدد ما إذا كان يجب عرض المورد القابل للتبديل أم اسم المورد فقط بعد الطفرة.
على سبيل المثال، تقبل طريقة MutateCampaigns للسمة CampaignService MutateCampaignsRequest وتتألف من:
customerId- مجموعة من
CampaignOperationكائنات - يعرض الحقل
response_content_typeنوع الاستجابة المفضّل.
العمليات
يتيح لك كائن العملية، مثل CampaignOperation، تحديد الإجراء الذي تريد تنفيذه على مورد واحد من خلال ضبط حقل operation. هذا الحقل هو حقل واحد
يتكون من السمات التالية التي يكون نوعها نوع المورد:
create- ينشئ مثيلًا جديدًا للمورد.
update- يتم تحديث المورد ليتطابق مع سمات مورد
update. عندما يتم تعيين هذا الحقل، يجب أيضًا تعيينupdate_maskمن العملية، والذي يُعلم إعلانات Google API بالسمات التي يلزم تعديلها أثناء عملية التحديث. تحتوي كل مكتبة عميلة على طريقة مساعدة أو أداة مساعدة من شأنها إنشاءupdate_maskلك، كما يتضح في مكتبات العميل. remove- يزيل المورد.
بما أن الحقل operation هو الحقل oneof، لا يمكنك استخدام عملية واحدة لتعديل عدة كائنات. على سبيل المثال، إذا كنت ترغب في إنشاء حملة واحدة وإزالة حملة أخرى، فأضف حالتين من CampaignOperation إلى طلبك: حالة مع تعيين create، وأخرى مع تعيين remove.
عمليات التجميع
على الرغم من أن عملية واحدة يمكنها فقط إنشاء مورد واحد أو تحديثه أو إزالته، يمكن أن يحتوي طلب التبديل الواحد على عمليات متعددة. ينبغي لك دمج عملياتك في طلب واحد للتبديل بدلاً من إرسال عدة طلبات تحويل تحتوي كل عملية على عملية واحدة.
على سبيل المثال، إذا كنت تريد إنشاء عشر حملات، ينبغي إرسال
أغنية MutateCampaignsRequest تحتوي على عشرة عناصر CampaignOperation.
تبديل الردود
يعتمد ما يتم عرضه في الرد على ما تم إرساله في response_content_type من طلب التبديل. على سبيل المثال، إذا تم تحديد MUTABLE_RESOURCE، حينئذٍ
ستحتوي الاستجابة على الحقول القابلة للتغيير في الحملة فقط. يمكنك بعد ذلك إجراء تحوّلات في المتابعة بشأن كائن المورد هذا بدون الحاجة إلى إعادة إنشائه.
أخطاء التبديل
لن يتم تطبيق العمليات في طلب التبديل المحدد على حسابك على "إعلانات Google" إلا إذا نجحت كل عملية في الطلب. راجع دليل الأخطاء الشائعة للحصول على قائمة بالأخطاء الشائعة وكيفية معالجتها.
فحص الكائنات التي تم إلغاء تنشيطها
بالإضافة إلى تغيير العناصر، تتضمن كل خدمة مخصصة لنوع المورد طريقة get لاسترداد جميع سمات المورد الفردي.
تقبل هذه الطريقة طلب الحصول على سمة واحدة فقط وهي resource_name.
تُعد طرق الاكتساب طريقة سهلة يقدمها إعلانات Google API لتسهيل استرداد جميع سمات كائن واحد. على الرغم من أن هذه أداة رائعة لتعلّم واجهة برمجة التطبيقات أو فحص كائن فردي لأغراض تصحيح الأخطاء أو الأغراض التعليمية، يجب ألا يستخدم تطبيقك طرقًا لاسترداد الكائنات لمعالجتها أو لإعداد تقارير عنها. بدلاً من ذلك، يمكنك استخدام السمة GoogleAdsService لأنها تتيح لك استرداد سمات معيّنة فقط من العناصر ودعم استرداد مقاييس الأداء والسماح بالبث من خلال مجموعات نتائج كبيرة. إذا أرسل تطبيقك عددًا كبيرًا
من طلبات الحصول على الطلبات، قد تواجه حدودًا في معدّل الزحف.