API Reference
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. يحتوي كل نوع من أنواع الموارد على طريقة واحدة أو أكثر وطريقة تمثيل واحدة أو أكثر للبيانات.
أنواع الموارد
-
الإحالة الناجحة
-
التقارير
-
SavedColumns
الإحالة الناجحة
للاطّلاع على تفاصيل "مصدر الإحالة الناجحة"، يُرجى الاطّلاع على صفحة تمثيل المورد.
| الطريقة |
طلب HTTP |
الوصف |
| معرّفات الموارد المنتظمة (URI) ذات الصلة بالموقع الإلكتروني https://www.googleapis.com/doubleclicksearch/v2، ما لم يُذكر خلاف ذلك |
|
الحصول
|
GET /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
|
يسترجع قائمة بالإحالات الناجحة من حساب محرك بحث DoubleClick Search.
مَعلمات طلب البحث المطلوبة:
endDate وrowCount وstartDate وstartRow |
|
getByCustomerId
|
GET /customer/customerId/conversion
|
يسترجع قائمة بالإحالات الناجحة من حساب محرّك بحث DoubleClick Search باستخدام رقم تعريف عميل جديد في "إعلانات شبكة البحث 360".
مَعلمات طلب البحث المطلوبة:
endDate وrowCount وstartDate وstartRow |
|
إدراج
|
POST /conversion
|
تُستخدَم هذه الوظيفة لإدراج مجموعة من الإحالات الناجحة الجديدة في DoubleClick Search.
|
|
تعديل
|
PUT /conversion
|
لتعديل مجموعة من الإحالات الناجحة في DoubleClick Search
|
|
updateAvailability
|
POST /conversion/updateAvailability
|
تعديل مدى توفّر مجموعة من أنشطة Floodlight في DoubleClick Search
|
التقارير
| الطريقة |
طلب HTTP |
الوصف |
| معرّفات الموارد المنتظمة (URI) ذات الصلة بالموقع الإلكتروني https://www.googleapis.com/doubleclicksearch/v2، ما لم يُذكر خلاف ذلك |
|
getIdMappingFile
|
GET /agency/agencyId/advertiser/advertiserId/idmapping
|
تنزيل ملف CSV (مُشفَّر بترميز UTF-8) يحتوي على عمليات ربط أرقام التعريف بين التجربة السابقة من "إعلانات شبكة البحث 360" والتجربة الجديدة من "إعلانات شبكة البحث 360" بالنسبة إلى المعلِن المطلوب، يتضمّن الملف جميع الكيانات الفرعية (مثل حسابات محرّكات البحث والحملات والمجموعات الإعلانية وما إلى ذلك) المتوفّرة في كلّ من التجربة السابقة من "إعلانات شبكة البحث 360" والتجربة الجديدة من "إعلانات شبكة البحث 360".
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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. |"]]
