Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
ลำดับชั้นและการเป็นเจ้าของทรัพยากรของบัญชี Search Ads 360
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
บัญชีในลําดับชั้นของ Search Ads 360 เวอร์ชันใหม่มี 3 ประเภท ได้แก่
บัญชีดูแลจัดการ - ก่อนหน้านี้เรียกว่า "บัญชีเอเจนซี" นี่คือระดับบนสุดของลำดับชั้นบัญชี Search Ads 360 ซึ่งใช้สำหรับการดูแลระบบและการรายงานในบัญชีดูแลจัดการย่อยและบัญชีลูกค้าระดับล่าง
บัญชีดูแลจัดการย่อย ซึ่งก่อนหน้านี้เรียกว่า "บัญชีผู้ลงโฆษณา" บัญชีผู้จัดการย่อยทำหน้าที่เป็นจุดเดียวในการจัดการและรายงานทั่วทั้งบัญชีลูกค้าที่ตนจัดการ
บัญชีลูกค้า - ก่อนหน้านี้เรียกว่า "บัญชีเครื่องมือค้นหา" บัญชีลูกค้าประกอบด้วยแคมเปญ กลุ่มโฆษณา และรายการอื่นๆ
ดูข้อมูลเพิ่มเติมเกี่ยวกับลําดับชั้นบัญชี Search Ads 360
ทรัพยากร Search Ads 360 แต่ละรายการจะเป็นเจ้าของที่ระดับบัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย หรือบัญชีลูกค้า
หากต้องการค้นหาทรัพยากร คุณจะต้องผ่านการตรวจสอบสิทธิ์ที่ระดับบัญชีเจ้าของหรือสูงกว่า เมื่อได้รับการตรวจสอบสิทธิ์ที่ระดับบัญชีเจ้าของที่เหมาะสมแล้ว คุณต้องใส่รหัสเฉพาะของบัญชีที่เป็นเจ้าของข้อมูลที่ขอลงในการค้นหา
ตัวอย่างเช่น ทรัพยากร CustomColumn เป็นเจ้าของที่ระดับบัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อย ส่วนทรัพยากร Campaign เป็นเจ้าของที่ระดับบัญชีลูกค้า ซึ่งหมายความว่าหากต้องการค้นหา CustomColumn คุณต้องผ่านการตรวจสอบสิทธิ์ที่ระดับบัญชีบัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อย คุณต้องระบุรหัสของบัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อยที่เป็นเจ้าของ CustomColumn ที่ขอไว้ในการค้นหาด้วย หากต้องการค้นหาข้อมูล Campaign คุณอาจต้องตรวจสอบสิทธิ์ที่ระดับบัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อย นอกจากนี้ คุณต้องระบุรหัสของบัญชีลูกค้าที่เป็นเจ้าของข้อมูลแคมเปญที่ขอในข้อความค้นหา
ทำความเข้าใจลําดับชั้นของบัญชี
หากต้องการสร้างรายงานโดยใช้ Search Ads 360 Reporting API คุณต้องเข้าใจลําดับชั้นบัญชีก่อน โดยระบุความสัมพันธ์ระหว่างบัญชีหลักและบัญชีย่อยระหว่างบัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย และบัญชีลูกค้าที่คุณจะค้นหา
ระบุบุตรหลานภายใต้บัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อย
หากต้องการดูโครงสร้างของบัญชีย่อยภายใต้บัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อย ให้สร้างคำสั่งภาษาในการค้นหาของ Search Ads 360 เพื่อค้นหาบัญชีย่อยโดยตรงทั้งหมดจากทรัพยากร CustomerClient จากนั้นให้ค้นหาทรัพยากร CustomerClient สำหรับบัญชีย่อยโดยตรงแต่ละบัญชีซ้ำเพื่อแสดงบัญชีย่อยที่ลิงก์กับบัญชีดูแลจัดการหรือบัญชีดูแลจัดการย่อยโดยอ้อม
การระบุผู้จัดการ (ระดับบนสุด) ของบัญชี
หากต้องการระบุบัญชีระดับบนสุดของบัญชีลูกค้า ให้ค้นหาแหล่งข้อมูล CustomerManagerLink
การสร้างรายงานจากข้อมูลของบัญชีหลายระดับ
ในบางกรณี คุณต้องใช้ข้อมูลจากระดับบัญชีหลายระดับเพื่อสร้างรายงาน เช่น คุณอาจได้รับข้อมูลส่วนใหญ่จากแหล่งข้อมูล Campaign ที่ระดับบัญชีลูกค้า แต่ต้องใช้ข้อมูลสนับสนุนจากแหล่งข้อมูล CustomColumn ที่ระดับบัญชีดูแลจัดการย่อยด้วย
ทรัพยากรที่เป็นเจ้าของในระดับบัญชีต่างๆ
ทรัพยากรบางอย่าง เช่น BiddingStrategy อาจเป็นของบัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย และบัญชีลูกค้า ในกรณีเหล่านี้ บัญชีลูกค้ามักจะมีสิทธิ์เข้าถึงข้อมูลทรัพยากรชุดย่อยที่แตกต่างกัน
แม้ว่า Search Ads 360 Reporting API จะมีเมตริกสําหรับทรัพยากรส่วนใหญ่เฉพาะในระดับบัญชีลูกค้า แต่ทรัพยากรบางรายการ เช่น BiddingStrategy จะรับเมตริกได้ในระดับบัญชีดูแลจัดการและบัญชีดูแลจัดการย่อย
การเป็นเจ้าของทรัพยากร
ตารางต่อไปนี้แสดงการเป็นเจ้าของระดับบัญชีสําหรับทรัพยากร Search Ads 360 แต่ละรายการ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\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 |"]]
