Conversion: get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لاسترداد قائمة بالإحالات الناجحة من حساب محرك بحث DoubleClick.
تجربة ذلك الآن
الطلب
طلب HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
المعلمات
| اسم المعلَمة |
القيمة |
الوصف |
| مَعلمات المسار |
advertiserId |
long |
الرقم التعريفي الرقمي للمعلِن
|
agencyId |
long |
المعرّف الرقمي للوكالة.
|
engineAccountId |
long |
رقم التعريف الرقمي لحساب محرّك البحث
|
| مَعلمات طلب البحث المطلوبة |
endDate |
integer |
تاريخ آخر (شامل) يتم استرداد الإحالات الناجحة فيه. التنسيق هو yyyymmdd.
تتراوح القيم المقبولة بين 20091101 و99991231 بشكل شامل.
|
rowCount |
integer |
عدد الإحالات الناجحة المطلوب عرضها لكل مكالمة.
تتراوح القيم المقبولة بين 1 و1000 بشكل شامل.
|
startDate |
integer |
التاريخ الأول (شامل) الذي يتم فيه استرداد الإحالات الناجحة. التنسيق هو yyyymmdd.
تتراوح القيم المقبولة بين 20091101 و99991231 بشكل شامل.
|
startRow |
unsigned integer |
فهرس البدء المستند إلى 0 لاسترداد نتائج الإحالات الناجحة.
|
| مَعلمات طلب البحث الاختيارية |
adGroupId |
long |
رقم التعريف الرقمي للمجموعة الإعلانية.
|
adId |
long |
المعرّف الرقمي للإعلان.
|
campaignId |
long |
المعرّف الرقمي للحملة.
|
criterionId |
long |
المعرّف الرقمي للمعيار.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a list of conversions from a specified DoubleClick Search engine account within a given date range.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include specifying the agency, advertiser, engine account, date range, and result pagination.\u003c/p\u003e\n"],["\u003cp\u003eOptionally filter conversions by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a Conversion resource containing details about the retrieved conversions.\u003c/p\u003e\n"]]],["This method retrieves conversions from a DoubleClick Search engine account. It requires authorization and uses a GET request with specific path and query parameters. Mandatory parameters include `agencyId`, `advertiserId`, `engineAccountId`, `endDate`, `rowCount`, `startDate`, and `startRow`. Optional parameters include `adGroupId`, `adId`, `campaignId`, and `criterionId`. The successful response contains a list of conversion resources. No request body is needed.\n"],null,["# Conversion: get\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account.\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/engine/engineAccountId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-------------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | Numeric ID of the advertiser. |\n| `agencyId` | `long` | Numeric ID of the agency. |\n| `engineAccountId` | `long` | Numeric ID of the engine account. |\n| **Required query parameters** |||\n| `endDate` | `integer` | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `rowCount` | `integer` | The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive. |\n| `startDate` | `integer` | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `startRow` | `unsigned integer` | The 0-based starting index for retrieving conversions results. |\n| **Optional query parameters** |||\n| `adGroupId` | `long` | Numeric ID of the ad group. |\n| `adId` | `long` | Numeric ID of the ad. |\n| `campaignId` | `long` | Numeric ID of the campaign. |\n| `criterionId` | `long` | Numeric ID of the criterion. |\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 [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\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.conversion.get)."]]
