Reports: listreports
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لاسترداد التقارير المخزَّنة
تجربة ذلك الآن
الطلب
طلب HTTP
GET https://www.googleapis.com/doubleclickbidmanager/v1.1/queries/queryId/reports
المعلمات
| اسم المعلَمة |
القيمة |
الوصف |
| مَعلمات المسار |
queryId |
long |
رقم تعريف طلب البحث المرتبط بالتقارير.
|
| مَعلمات طلب البحث الاختيارية |
pageSize |
integer |
الحد الأقصى لعدد النتائج في كل صفحة يجب أن تتراوح القيم بين 1 و
100 ويتم ضبط القيمة التلقائية على 100 في حال عدم تحديدها.
|
pageToken |
string |
رمز مميّز اختياري للتقسيم على صفحات.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/doubleclickbidmanager |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا تقدِّم نص طلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{
"kind": "doubleclickbidmanager#listReportsResponse",
"reports": [
reports Resource
],
"nextPageToken": string
}
| اسم الموقع |
القيمة |
الوصف |
ملاحظات |
reports[] |
list |
يتم استرجاع التقارير. |
|
kind |
string |
يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "doubleclickbidmanager#listReportsResponse" |
|
nextPageToken |
string |
الرمز المميز للتقسيم على صفحات للصفحة التالية، إن وجد. |
|
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis version of the Bid Manager API is sunsetted, and users should migrate to Bid Manager API v2.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this version may return errors, and certain fields in retrieved \u003ccode\u003eQuery\u003c/code\u003e resources will be empty.\u003c/p\u003e\n"],["\u003cp\u003eThis API retrieves stored reports associated with a specific query ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["The Bid Manager API v1.1 is sunset, and users must migrate to v2. Requests to v1.1 may error, and if successful, `Query` resources will have empty fields: `metadata.googleCloudStoragePathForLatestReport`, `metadata.latestReportRunTimeMs`, and `metadata.googleDrivePathForLatestReport`. To retrieve stored reports, use a `GET` request to `queries/queryId/reports`, including the `queryId` and optional `pageSize` and `pageToken`. Authorization with the `doubleclickbidmanager` scope is required. A successful response returns a list of reports, the kind of response, and next page token.\n"],null,["# Reports: listreports\n\n| This version of the Bid Manager API has been sunset. Users must [migrate to Bid Manager API v2](/bid-manager/how-tos/v2-migration).\n|\n|\n| Requests to this version may return an error. If the request is successful, the following fields in retrieved [`Query`](/bid-manager/v1.1/queries#resource) resources will be empty:\n|\n| - [`metadata.googleCloudStoragePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleCloudStoragePathForLatestReport)\n| - [`metadata.latestReportRunTimeMs`](/bid-manager/v1.1/queries#metadata.latestReportRunTimeMs)\n| - [`metadata.googleDrivePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleDrivePathForLatestReport)\n|\n| \u003cbr /\u003e\n|\n| **Note:** Requires [authorization](#auth).\n\nRetrieves stored reports.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclickbidmanager/v1.1/queries/queryId/reports\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `queryId` | `long` | Query ID with which the reports are associated. |\n| **Optional query parameters** |||\n| `pageSize` | `integer` | Maximum number of results per page. Must be between `1` and `100`. Defaults to `100` if unspecified. |\n| `pageToken` | `string` | Optional pagination token. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclickbidmanager` |\n\nFor more information, see the [authentication and authorization](/bid-manager/how-tos/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\": \"doubleclickbidmanager#listReportsResponse\",\n \"reports\": [\n reports Resource\n ],\n \"nextPageToken\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|------------------------------------------------------------------------------------------------------------------|-------|\n| `reports[]` | `list` | Retrieved reports. | |\n| `kind` | `string` | Identifies what kind of resource this is. Value: the fixed string `\"doubleclickbidmanager#listReportsResponse\"`. | |\n| `nextPageToken` | `string` | Next page's pagination token if one exists. | |\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/doubleclickbidmanager/v1.1/doubleclickbidmanager.reports.listreports)."]]
