أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
Method: customers.customColumns.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض جميع الأعمدة المخصّصة المرتبطة بالعميل بالتفاصيل الكاملة.
طلب HTTP
GET https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
customerId |
string
مطلوب. رقم تعريف العميل المطلوب تطبيق عملية قائمة العمود المخصّص عليه.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ لاسترجاع جميع الأعمدة المخصّصة المرتبطة بعميل.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"customColumns": [
{
object (CustomColumn)
}
]
} |
| الحقول |
customColumns[] |
object (CustomColumn)
الأعمدة المخصّصة التي يملكها العميل المقدَّم.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/doubleclicksearch
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves detailed information about all custom columns associated with a specific customer.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP GET request with the customer ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns a JSON response containing an array of custom columns.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details retrieving customer-specific custom columns via an API. A `GET` request to `https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns` is made, where `customerId` is a required path parameter. The request body must be empty. A successful response returns a JSON structure with an array of `customColumns` objects containing custom column details, requiring the authorization scope `https://www.googleapis.com/auth/doubleclicksearch`.\n"],null,["# Method: customers.customColumns.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCustomColumnsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns all the custom columns associated with the customer in full detail.\n\n### HTTP request\n\n`GET https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------|\n| `customerId` | `string` Required. The ID of the customer to apply the CustomColumn list operation to. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for fetching all custom columns associated with a customer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"customColumns\": [ { object (/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumn) } ] } ``` |\n\n| Fields ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customColumns[]` | `object (`[CustomColumn](/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumn)`)` The CustomColumns owned by the provided customer. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/doubleclicksearch`"]]
