أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
التنسيقات في Search Ads 360 Reporting API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعتمد تنسيق الطلب على نوع الطلب الذي تقدّمه.
بحث
يمكنك تخصيص نتائج البحث من خلال تحديد طلب بحث
لتناسب احتياجاتك. تسمح لك لغة طلبات البحث في "إعلانات شبكة البحث 360" بالبحث في كل
الموارد عن قائمة بالكيانات التي تتطابق مع مجموعة معيّنة من المعايير. يتم تقديم جميع
الطلبات، بغض النظر عن نوع العنصر، ضد
SearchAds360Service. اطّلِع على إنشاء تقارير نتائج البحث ولغة طلبات البحث في "إعلانات شبكة البحث 360" لمزيد من المعلومات.
تعتمد الحقول التي يتم تعبئتها في الاستجابة على الخدمة التي تستخدمها:
SearchAds360Service- يتضمّن الردّ عنصر
SearchAds360Row واحدًا لكلّ عنصر
يتطابق مع مَعلمات البحث. يحتوي كل صف على عنصر واحد، مثل
حملة، ويتضمن فقط الحقول التي تطلبها في طلب البحث.
- خدمات محدّدة
- يمكنك طلب عنصر واحد فقط في كل مرة حسب اسم المورد. يتضمّن الردّ
جميع حقول هذا العنصر.
في واجهة برمجة التطبيقات الجديدة، يجب تحديد رقم تعريف العميل على أنّه رقم مكوّن من 10 أرقام
(XXXXXXXXXX) بدون شرط.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSearch Ads 360 API request formats vary depending on whether you're searching or requesting specific entities.\u003c/p\u003e\n"],["\u003cp\u003eSearches utilize the Search Ads 360 Query Language and the \u003ccode\u003eSearchAds360Service\u003c/code\u003e for customized results.\u003c/p\u003e\n"],["\u003cp\u003eResponses from \u003ccode\u003eSearchAds360Service\u003c/code\u003e include a \u003ccode\u003eSearchAds360Row\u003c/code\u003e for each matching entity, containing only the requested fields.\u003c/p\u003e\n"],["\u003cp\u003eRequests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes.\u003c/p\u003e\n"]]],["Search requests utilize the Search Ads 360 Query Language against the `SearchAds360Service` to retrieve entities matching specific criteria. Responses from `SearchAds360Service` return `SearchAds360Row` objects, including only requested fields. Specific service requests retrieve one entity by resource name, returning all its fields. The Customer ID in the API must be a 10-digit number without dashes. The user can use the \"Create search reports\" or \"Search Ads 360 Query Language\" to learn more.\n"],null,["# Formats in the Search Ads 360 Reporting API\n\nRequest format\n--------------\n\nThe request format depends on the type of request you make.\n\n### Search\n\nYou can customize your search output by defining a search query\nto suit your needs. The Search Ads 360 Query Language allows you to search all\nresources for a list of entities that match a specific set of criteria. All\nrequests, regardless of the entity type, are made against the\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service). See [Create search reports](/search-ads/reporting/concepts/search-reports) and\n[Search Ads 360 Query Language](/search-ads/reporting/query/query-language)\nto learn more.\n\nResponse format\n---------------\n\nThe fields populated in the response depend on the service you use:\n\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service)\n: The response includes one [`SearchAds360Row`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360row) object for each entity that\n matches your search parameters. Each row contains one object, for example, a\n campaign, and includes *only* the fields you request in your query.\n\nSpecific services\n: You can only request one entity at a time by resource name. The response\n includes *all* fields for that entity.\n\nCustomer ID format\n------------------\n\nIn the new API, you must specify your Customer ID as a 10-digit number\n(`XXXXXXXXXX`) without dashes."]]
