يُرجى العلم أنّنا سنوقف نهائيًا الطريقتَين get وgetByCustomerId في Search Ads 360 Conversion API في الربع الثالث من عام 2025. لمواصلة الوصول إلى بيانات الإحالات الناجحة، عليك إنشاء تقرير باستخدام مصدر الإحالة الناجحة باستخدام Search Ads 360 Reporting API الجديدة. يمكنك الاطّلاع على مزيد من التفاصيل هنا.
يصنّف هذا العنصر على أنّه مورد SaveColumnList. القيمة: السلسلة الثابتة doubleclicksearch#savedColumnList
items[]
list
الأعمدة المحفوظة المطلوبة.
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 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)."]]
