أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
التدرّج الهرمي لحساب "إعلانات شبكة البحث 360" وملكية الموارد
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتوفّر ثلاثة أنواع من الحسابات في التدرّج الهرمي للتجربة الجديدة من "إعلانات شبكة البحث 360":
الحساب الإداري: كان يُعرف سابقًا باسم "حساب الوكالة". هذا هو المستوى الأعلى
للتدرّج الهرمي لحساب "إعلانات شبكة البحث 360"، ويتم استخدامه للإدارة
وإعداد التقارير عن حسابات المدراء الفرعيين وحسابات العملاء ذات المستوى الأدنى.
حسابات المدراء الفرعيين - كانت تُعرف سابقًا باسم "حسابات المعلِنين". تُعدّ حسابات المدراء
الفرعيين نقاطًا مركزية لإدارة إعداد التقارير في حسابات العميل
التي تديرها.
حسابات العملاء - كانت تُعرف سابقًا باسم "حسابات محركات البحث". يتضمّن حساب العميل
الحملات والمجموعات الإعلانية والعناصر الأخرى.
مزيد من المعلومات عن التدرّج الهرمي لحساب "إعلانات شبكة البحث 360"
يكون كلّ مورد في "إعلانات شبكة البحث 360" مملوكًا على مستوى الحساب الإداري أو حساب المدير الفرعي أو
مستوى حساب العميل.
لإجراء طلب بحث عن مورد، يجب أن تكون مصادقًا على مستوى حساب المالك أو
أعلى. بعد مصادقة حسابك على مستوى حساب المالك المناسب،
يجب تضمين رقم التعريف المحدّد للحساب الذي يملك
البيانات المطلوبة في طلب البحث.
على سبيل المثال، يكون المورد CustomColumn
مملوكًا على مستوى الحساب الإداري أو حساب المدير الفرعي، بينما يكون المورد Campaign
مملوكًا على مستوى حساب العميل. وهذا يعني أنّه لإجراء طلب بحث في
CustomColumn
يجب أن تكون مصادقًا على مستوى الحساب الإداري أو حساب المدير الفرعي. عليك
أيضًا تحديد رقم تعريف الحساب الإداري أو حساب المدير الفرعي الذي يملك CustomColumn المطلوب في طلب البحث. لإجراء طلب بحث عن بيانات Campaign
، قد تتم مصادقة حسابك على مستوى الحساب الإداري أو حساب المدير الفرعي. بالإضافة إلى ذلك، يجب تحديد رقم تعريف حساب العميل
الذي يملك بيانات الحملة المطلوبة في طلبك.
فهم التدرّج الهرمي للحساب
لإنشاء تقارير باستخدام Search Ads 360 Reporting API، عليك أولاً معرفة التدرّج الهرمي للحساب من خلال تحديد العلاقات بين العناصر الرئيسية والعناصر الفرعية بين الحسابات الإدارية والحسابات الإدارية الفرعية وحسابات العملاء التي تُجري عليها طلب بحث.
تحديد الأطفال ضمن حساب إداري أو حساب مدير فرعي
للاطّلاع على بنية الحسابات الفرعية ضمن حساب إداري أو حساب مدير فرعي، أنشِئ عبارة بلغة طلب البحث في "إعلانات شبكة البحث 360" لإجراء طلب بحث في جميع الحسابات الفرعية المباشرة من مورد CustomerClient. بعد ذلك، يمكنك إجراء طلب بحث متكرّر عن مورد CustomerClient لكل حساب CustomerClient فرعي مباشر لعرض الحسابات الفرعية المرتبطة بشكل غير مباشر بالحساب الإداري أو حساب المدير الفرعي.
تحديد الحساب الإداري (الرئيسي) لحساب معيّن
لتحديد المصدر الرئيسي لحساب عميل، يمكن طلب البحث عن
المرجع CustomerManagerLink.
إنشاء تقارير تتضمّن بيانات من مستويات حسابات متعددة
في بعض الحالات، ستحتاج إلى استخدام بيانات من مستويات حساب متعددة لإنشاء تقرير. على سبيل المثال، قد تحصل على معظم بياناتك من مورد Campaign
على مستوى حساب العميل، ولكنّها قد تطلب أيضًا بيانات داعمة من المورد
CustomColumn
على مستوى حساب المدير الفرعي.
الموارد المملوكة على مستويات مختلفة من الحساب
يمكن أن تكون بعض الموارد، مثل BiddingStrategy،
مملوكة على مستوى الحساب الإداري وحساب المدير الفرعي وحساب العميل. في هذه
الحالات، يمكن لحسابات العملاء عادةً الوصول إلى مجموعات فرعية مختلفة من
بيانات الموارد.
على الرغم من أنّ Search Ads 360 Reporting API يوفّر مقاييس لمعظم
الموارد على مستوى حساب العميل فقط، يمكن لبعض الموارد، مثل BiddingStrategy الحصول على مقاييس على الصعيدين
الإداري والفرعي.
ملكية الموارد
يعرض الجدول التالي الملكية على مستوى الحساب لكلّ مورد في "إعلانات شبكة البحث 360".
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSearch Ads 360 utilizes a three-tiered account hierarchy consisting of Manager, Sub-manager, and Client accounts for administration, reporting, and campaign management.\u003c/p\u003e\n"],["\u003cp\u003eTo query a resource, users need to authenticate at or above the resource's owner account level and specify the owning account's ID in their query.\u003c/p\u003e\n"],["\u003cp\u003eBuilding reports may require understanding parent-child relationships between accounts and utilizing data from multiple account levels.\u003c/p\u003e\n"],["\u003cp\u003eDifferent Search Ads 360 resources are owned at different account levels (Manager, Sub-manager, or Client) as outlined in the provided resource ownership table.\u003c/p\u003e\n"],["\u003cp\u003eSome resources, like BiddingStrategy, can be owned at multiple account levels, offering varying levels of access to resource data for client accounts.\u003c/p\u003e\n"]]],["Search Ads 360 uses a three-tiered account hierarchy: Manager, Sub-manager, and Client. To query resources, authenticate at or above the owner's account level and include the owner's ID in your query. Identify child accounts under a manager or sub-manager using the `CustomerClient` resource, and identify parent accounts using `CustomerManagerLink`. Reports often require data from multiple account levels. Resource ownership varies; for instance, `CustomColumn` is owned by Manager/Sub-manager, while `Campaign` is Client-owned.\n"],null,["# Search Ads 360 account hierarchy and resource ownership\n\nThere are three types of accounts in the new Search Ads 360 hierarchy:\n\n- Manager Account - previously called an \"agency account.\" This is the top\n level of the Search Ads 360 account hierarchy and is used for administration and\n reporting across the lower-level sub-manager and client accounts.\n\n- Sub-manager accounts - previously called \"advertiser accounts.\" Sub-manager\n accounts act as single points of administration and reporting across the client\n accounts that they manage.\n\n- Client accounts - previously called \"engine accounts.\" A client account\n contains the campaigns, ad groups, and other items.\n\nLearn more about the [Search Ads 360 account hierarchy](https://support.google.com/sa360/answer/9158072).\n\nEach Search Ads 360 resource is owned at either the manager, sub-manager or\nclient account level.\n\nTo query a resource you must be authenticated at the owner account level or\nhigher. Once you are authenticated at the appropriate owner account level, you\nmust include in your query the specific ID of the account that owns the\nrequested data.\n\nFor example, the [`CustomColumn`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.CustomColumn)\nresource is owned at the manager or sub-manager account level, while the [`Campaign`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaign)\nresource is owned at the client account level. This means that to query\n[`CustomColumn`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.CustomColumn)\nyou must be authenticated at the manager or sub-manager account level. You must\nalso specify in your query the ID of the manager or sub-manager account that\nowns the requested `CustomColumn`. To query [`Campaign`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaign)\ndata you may be authenticated at either the manager or sub-manager account\nlevel. In addition, you must specify in your query the ID of the client account\nthat owns the requested Campaign data.\n\nUnderstanding the account hierarchy\n-----------------------------------\n\nTo build reports using the Search Ads 360 Reporting API you must first\nunderstand the account hierarchy by identifying the parent-child relationships\nbetween the manager, sub-manager, and client accounts that you are querying.\n\n### Identify children under a manager or sub-manager account\n\nTo see the structure of the child accounts under a manager or sub-manager\naccount, build a Search Ads 360 Query Language statement to query all direct\nchild accounts from the [`CustomerClient`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#customerclient)\nresource. Then iteratively query the `CustomerClient` resource for each direct\nchild account to return the child accounts that are linked indirectly to the\nmanager or sub-manager account.\n\n### Identifying the manager (parent) of an account\n\nTo identify the parent of a customer account, query the [`CustomerManagerLink`](/search-ads/reporting/api/reference/fields/v0/customer_manager_link)\nresource.\n\nBuilding reports with data from multiple account levels\n-------------------------------------------------------\n\nIn some cases you will need to use data from multiple account levels to build a\nreport. For example you may get most of your data from the [`Campaign`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.Campaign)\nresource at the client account level, but also require supporting data from the\n[`CustomColumn`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.CustomColumn)\nresource at the sub-manager account level.\n\nResources owned at different account levels\n-------------------------------------------\n\nSome resources, such as [`BiddingStrategy`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#biddingstrategy),\ncan be owned at the manager, sub-manager and client account levels. In these\ninstances, the client accounts typically have access to different subsets of\nresource data.\n\nWhile the Search Ads 360 Reporting API provides metrics for most\nresources only at the client account level, some resources, like [`BiddingStrategy`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#biddingstrategy) can get metrics at the\nmanager and sub-manager levels.\n\nResource Ownership\n------------------\n\nThe following table shows the account-level ownership for each Search Ads 360 resource.\n\n| Search Ads 360 Resource | Account Level Ownership |\n|----------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|\n| [Customer](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.Customer) | Manager, Sub-manager and Client |\n| [AdGroup](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.AdGroup) | Client |\n| [AdGroupAd](/search-ads/reporting/api/reference/rpc) | Client |\n| [AdGroupCriterion](/search-ads/reporting/api/reference/rpc) | Client |\n| [BiddingStrategy](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#biddingstrategy) | Sub-manager and Client |\n| [Campaign](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaign) | Client |\n| [CampaignCriterion](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaigncriterion) | Client |\n| [ExtensionFeedItem](/search-ads/reporting/api/reference/rpc) | Client |\n| [ConversionAction](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#conversionaction) | Sub-manager (excluding metrics) and Client |\n| [CustomerManagerLink](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#customermanagerlink) | Sub-manager and Client |\n| [CustomColumn](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#customcolumn) | Manager and Sub-manager |"]]
