يُرجى العلم أنّنا سنوقف نهائيًا الطريقتَين get وgetByCustomerId في Search Ads 360 Conversion API في الربع الثالث من عام 2025. لمواصلة الوصول إلى بيانات الإحالات الناجحة، عليك إنشاء تقرير باستخدام مصدر الإحالة الناجحة باستخدام Search Ads 360 Reporting API الجديدة. يمكنك الاطّلاع على مزيد من التفاصيل هنا.
GET /agency/agencyId/advertiser/advertiserId/idmapping
تنزيل ملف CSV (مُشفَّر بترميز UTF-8) يحتوي على عمليات ربط أرقام التعريف بين التجربة السابقة من "إعلانات شبكة البحث 360" والتجربة الجديدة من "إعلانات شبكة البحث 360" بالنسبة إلى المعلِن المطلوب، يتضمّن الملف جميع الكيانات الفرعية (مثل حسابات محرّكات البحث والحملات والمجموعات الإعلانية وما إلى ذلك) المتوفّرة في كلّ من التجربة السابقة من "إعلانات شبكة البحث 360" والتجربة الجديدة من "إعلانات شبكة البحث 360".
تاريخ التعديل الأخير: 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\u003eThis API reference is organized by resource type, with each type having one or more data representations and methods.\u003c/p\u003e\n"],["\u003cp\u003eThe available resource types are Conversion, Reports, and SavedColumns.\u003c/p\u003e\n"],["\u003cp\u003eConversion resource allows you to retrieve, insert, update, and manage the availability of conversions in DoubleClick Search.\u003c/p\u003e\n"],["\u003cp\u003eReports resource provides functionality to download a CSV file containing ID mappings between previous and new Search Ads 360 for a given advertiser.\u003c/p\u003e\n"]]],["This API reference outlines three resource types: Conversion, Reports, and SavedColumns. The Conversion resource supports methods to `get`, `getByCustomerId`, `insert`, `update`, and `updateAvailability` conversions. These methods manage lists and batches of conversions. The Reports resource includes the `getIdMappingFile` method, which downloads a CSV file of ID mappings between old and new Search Ads 360 systems, encompassing all child entities. Each method has specific HTTP request paths.\n"],null,["# API Reference\n\nThis API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.\n\nResource types\n--------------\n\n1. [Conversion](#Conversion)\n2. [Reports](#Reports)\n3. [SavedColumns](#SavedColumns)\n\nConversion\n----------\n\nFor Conversion Resource details, see the [resource representation](/search-ads/v2/reference/conversion#resource) page.\n\n| Method | HTTP request | Description |\n|------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| URIs relative to https://www.googleapis.com/doubleclicksearch/v2, unless otherwise noted |||\n| [get](/search-ads/v2/reference/conversion/get) | `GET /agency/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eagencyId\u003c/var\u003e`/advertiser/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eadvertiserId\u003c/var\u003e`/engine/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eengineAccountId\u003c/var\u003e`/conversion` | Retrieves a list of conversions from a DoubleClick Search engine account. \u003cbr /\u003e **Required query parameters:** `endDate`, `rowCount`, `startDate`, `startRow` |\n| [getByCustomerId](/search-ads/v2/reference/conversion/getByCustomerId) | `GET /customer/`\u003cvar class=\"apiparam\" translate=\"no\"\u003ecustomerId\u003c/var\u003e`/conversion` | Retrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID. \u003cbr /\u003e **Required query parameters:** `endDate`, `rowCount`, `startDate`, `startRow` |\n| [insert](/search-ads/v2/reference/conversion/insert) | `POST /conversion` | Inserts a batch of new conversions into DoubleClick Search. |\n| [update](/search-ads/v2/reference/conversion/update) | `PUT /conversion` | Updates a batch of conversions in DoubleClick Search. |\n| [updateAvailability](/search-ads/v2/reference/conversion/updateAvailability) | `POST /conversion/updateAvailability` | Updates the availabilities of a batch of floodlight activities in DoubleClick Search. |\n\nReports\n-------\n\n| Method | HTTP request | Description |\n|-----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| URIs relative to https://www.googleapis.com/doubleclicksearch/v2, unless otherwise noted |||\n| [getIdMappingFile](/search-ads/v2/reference/reports/getIdMappingFile) | `GET /agency/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eagencyId\u003c/var\u003e`/advertiser/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eadvertiserId\u003c/var\u003e`/idmapping` | Downloads a CSV file (encoded in UTF-8) that contains ID mappings between the previous Search Ads 360 and the new Search Ads 360. For the requested advertiser, the file includes all children entities (e.g. engine accounts, campaigns, ad groups, etc.) that exist in both the previous Search Ads 360 and the new Search Ads 360. |"]]
