أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
أسماء الموارد
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
التسلسل الهرمي للأسماء
تكون أسماء الموارد المستخدَمة في Search Ads 360 Reporting API هرمية، ما يعكس تنظيم الكيانات ضمن "إعلانات شبكة البحث 360". جميع الموارد تقريبًا هي موارد فرعية
من مورد Customer
، ما يعكس حقيقة أنّه على كل طلب بيانات من واجهة برمجة التطبيقات استهداف حساب
معيّن على "إعلانات شبكة البحث 360". على سبيل المثال، الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية هي جميعها موارد فرعية لمورد عميل أساسي.
يُشار إلى كيانات Search Ads 360 Reporting API (العملاء والحملات وما إلى ذلك) بأسماء مواردها في جميع أنحاء واجهة برمجة التطبيقات. ومع ذلك، من المهم ملاحظة أنّ أسماء الموارد
نفسها قد تتضمّن معرّفات موارد رقمية فريدة تحدّد
كل عنصر في التسلسل الهرمي. في هذه الحالات، قد يكون من المفيد تحليل اسم المورد لاستخراج معرّفات الموارد هذه وتجميع معرّف جديد.
على سبيل المثال، اطّلِع على اسم مورد AdGroupAd من الجدول السابق:
يمكن تقسيم هذا الاسم إلى معرّفات الموارد الفردية (مفصولة ب
معرّفات المجموعة)
على النحو التالي:
مكوّنات اسم المورد
معرّفات الموارد
رقم تعريف العميل:
"1234567890"
رقم تعريف المجموعة الإعلانية:
"54321098765"
رقم تعريف الإعلان في المجموعة الإعلانية:
"2109876543210"
معرّفات المجموعة
"customers"
"adGroupAds"
يتيح لك تحليل المعرّفات الفردية استخلاص أسماء موارد جديدة للإشارة إلى
عميل الإعلان في المجموعة الإعلانية (customers/1234567890) أو مجموعته الإعلانية
(customers/1234567890/adGroupAds/54321098765).
تاريخ التعديل الأخير: 2026-10-14 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2026-10-14 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]
