API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google
searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
Method: customers.customColumns.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تمام ستون های سفارشی مرتبط با مشتری را با جزئیات کامل برمی گرداند.
درخواست HTTP
GET https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
customerId | string مورد نیاز. شناسه مشتری برای اعمال عملیات فهرست CustomColumn. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای واکشی تمام ستون های سفارشی مرتبط با یک مشتری.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"customColumns": [
{
object (CustomColumn)
}
]
} |
| فیلدها |
|---|
customColumns[] | object ( CustomColumn ) ستون های سفارشی متعلق به مشتری ارائه شده است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/doubleclicksearch
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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`"]]
