المتطلّبات الأساسية

قبل أن تتمكّن من البدء في ترميز أول تطبيق عميل، عليك تنفيذ بعض الإجراءات، إذا لم تكن قد فعلت ذلك من قبل.

الحصول على حساب Google

أنت بحاجة إلى حساب Google من أجل إنشاء مشروع في وحدة تحكّم Google API. إذا كان لديك حساب، هذا يعني أنك جاهز للبدء.

وننصحك أيضًا باستخدام حساب Google منفصل لأغراض الاختبار.

تجربة تقرير "تجارب إعلانات Google"

تفترض وثائق واجهة برمجة التطبيقات هذه أنك استخدمت تقرير تجارب إعلانات Google وأنك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب.

إذا لم تكن قد استخدمت تقرير تجارب الإعلانات من Google، جرّب واجهة المستخدم قبل بدء الترميز.

إنشاء مشروع لعميلك

قبل أن تتمكن من إرسال طلبات إلى "تقرير تجارب إعلانات Google"، عليك إخبار Google عن عميلك وتفعيل الوصول إلى واجهة برمجة التطبيقات. ويمكنك إجراء ذلك باستخدام وحدة تحكّم Google API لإنشاء مشروع، وهو مجموعة مُعنونة من الإعدادات ومعلومات الوصول إلى واجهة برمجة التطبيقات، ثم تسجيل تطبيقك.

تعلُّم أساسيات REST

هناك طريقتان لاستدعاء واجهة برمجة التطبيقات:

إذا قررت عدم استخدام مكتبات العملاء، ستحتاج إلى فهم أساسيات REST.

وتُعدّ REST أسلوبًا من بنية البرامج التي توفّر منهجًا مريحًا ومتسقًا لطلب البيانات وتعديلها.

يشير المصطلح REST إلى الاختصار &reنقل في ولاية النقل التمثيلي.&quot وفي سياق واجهات برمجة تطبيقات Google، يشير إلى استخدام أفعال HTTP لاسترداد تمثيلات البيانات التي تم تخزينها بواسطة Google وتعديلها.

في نظام RESTful، يتم تخزين الموارد في مخزن بيانات، ويرسل العميل طلبًا بأن ينفذ الخادم إجراءً معيّنًا (مثل إنشاء مورد أو استرداده أو تحديثه أو حذفه)، ويتخذ الخادم الإجراء ويرسل استجابة، غالبًا في شكل تمثيل للمورد المحدد.

في واجهات برمجة تطبيقات RESTful في Google\u3d، يحدد العميل إجراءً باستخدام فعل HTTP مثل POST أو GET أو PUT أو DELETE. وتحدّد هذه السمة موردًا يستند إلى معرّف الموارد المنتظم (URI) الفريد من نوعه على مستوى العالم:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

ونظرًا لأن جميع موارد واجهة برمجة التطبيقات تتضمن معرّفات الموارد المنتظمة (URI) الفريدة التي يمكن الوصول إليها عبر HTTP، فإن بروتوكول REST يمكّن التخزين المؤقت للبيانات ويتم تحسينه للعمل مع البنية الأساسية الموزَّعة على الويب.

قد تجد تعريفات الطرق في مستندات معايير HTTP 1.1 مفيدة، وهي تشمل مواصفات GET وPOST وPUT وDELETE.

REST في واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google

يتم ربط عمليات واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google مباشرةً بأفعال HTTP REST.

في ما يلي التنسيقات المحددة لمعرّفات الموارد المنتظمة (URI) لتقرير "تجربة إعلانات Google".

https://adexperiencereport.googleapis.com/v1/resourcePath?parameters

يتم تلخيص المجموعة الكاملة من معرفات الموارد المنتظمة (URI) المستخدمة لكل عملية معتمدة في واجهة برمجة التطبيقات في مستند مرجع واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google.

تعرّف على أساسيات JSON

تعرض واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google البيانات بتنسيق JSON.

JSON (JavaScript Object Notation) هو تنسيق بيانات شائع مستقل عن اللغة، ويقدم تمثيلاً نصيًا بسيطًا لبنية البيانات العشوائية. لمزيد من المعلومات، يمكنك الاطّلاع على json.org.