أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تفترض هذه الصفحة أنّك على دراية بدليلَي المطوّرين تصميم موجّه نحو الموارد وأسماء الموارد، وتكمّلهما بتفاصيل تنفيذ محدّدة لواجهة برمجة التطبيقات Search Ads 360 Reporting API.
التصميم المرتكز على الموارد
بشكل عام، تتّبع Search Ads 360 Reporting API تصميمًا موجّهًا إلى الموارد، ويتم وضع نموذج لها على هيئة
مجموعات من الموارد التي يمكن الوصول إليها بشكلٍ فردي (الأسماء لواجهة برمجة التطبيقات).
تتم الإشارة إلى الموارد بأسماء مواردها ويتم التلاعب بها باستخدام مجموعة صغيرة
من الطرق (المعروفة أيضًا باسم الأفعال أو العمليات).
إنّ أسماء الموارد والطرق هذه، بالإضافة
إلى بادئة إصدار واجهة برمجة التطبيقات المحدّدة، تشكّل عناوين URL لواجهة REST.
على سبيل المثال، يمكن تقسيم عنوان URL أدناه إلى هذه المكوّنات الفردية وفقًا للجدول التالي:
جميع عناوين URL لبروتوكول REST لإصدار معيّن من واجهة برمجة التطبيقات (مثل v0)
مشاركة بادئة إصدار واجهة برمجة التطبيقات المشتركة يحدِّد اسم المورد وطريقة الاستخدام معًا
خدمة واجهة برمجة التطبيقات التي يتمّ طلبها.
تستخدِم Search Ads 360 Reporting API بشكلٍ كبير الطُرق المخصّصة، على عكس معظم
واجهات برمجة تطبيقات REST التقليدية التي تستخدِم طُرق REST العادية مثل list وget. تتضمّن Search Ads 360 Reporting API
طريقتَين مخصّصتَين: search وsearchStream.
تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Search Ads 360 Reporting API uses a resource-oriented design, where data is organized into collections of resources that can be accessed and manipulated."],["The API primarily uses custom methods like `search` and `searchStream` instead of traditional REST methods."],["API endpoints are constructed using an API version prefix, resource name, and method, which are detailed further in linked documentation."],["The guide's examples demonstrate API calls using HTTP, with further instructions available for using the `curl` command-line utility."],["Developers should be familiar with Resource Oriented Design and Resource Names before using this API."]]],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"]]
