SavedColumns: list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استرداد قائمة الأعمدة المحفوظة لمعلن محدّد.
تجربة ذلك الآن
الطلب
طلب HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/savedcolumns
المعلمات
| اسم المعلَمة |
القيمة |
الوصف |
| مَعلمات المسار |
advertiserId |
long |
رقم تعريف DS للمعلن.
|
agencyId |
long |
رقم تعريف DS للوكالة
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{
"kind": "doubleclicksearch#savedColumnList",
"items": [
savedColumns Resource
]
}
| اسم الموقع |
القيمة |
الوصف |
ملاحظات |
kind |
string |
يصنّف هذا العنصر على أنّه مورد SaveColumnList. القيمة: السلسلة الثابتة doubleclicksearch#savedColumnList |
|
items[] |
list |
الأعمدة المحفوظة المطلوبة. |
|
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieve a list of saved columns for a specific advertiser using the provided endpoint and required authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires agency and advertiser IDs as path parameters and does not include a request body.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will contain a list of saved columns along with resource kind information in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUsers can test the API using the provided APIs Explorer or a standalone explorer link.\u003c/p\u003e\n"]]],["This API endpoint retrieves a list of saved columns for a specific advertiser. It requires authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope. A `GET` request is sent to `https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/savedcolumns`, specifying the `agencyId` and `advertiserId` in the path. A successful response returns a `savedColumnList` resource containing an array of `savedColumns`. No request body is needed.\n"],null,["# SavedColumns: list\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieve the list of saved columns for a specified advertiser.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/savedcolumns\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------|--------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | DS ID of the advertiser. |\n| `agencyId` | `long` | DS ID of the agency. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"doubleclicksearch#savedColumnList\",\n \"items\": [\n savedColumns Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Identifies this as a SavedColumnList resource. Value: the fixed string `doubleclicksearch#savedColumnList`. | |\n| `items[]` | `list` | The saved columns being requested. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.savedColumns.list)."]]
