از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاریهای SDF که اعلانها را ارائه نمیکنند با شکست مواجه میشوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
Method: floodlightGroups.floodlightActivities.list
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
فعالیت های Floodlight را در یک گروه Floodlight لیست می کند.
درخواست HTTP
GET https://displayvideo.googleapis.com/v4/floodlightGroups/{floodlightGroupId}/floodlightActivities
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
floodlightGroupId | string ( int64 format) مورد نیاز. شناسه گروه اصلی Floodlight که فعالیتهای Floodlight درخواستی به آن تعلق دارند. |
پارامترهای پرس و جو
پارامترها |
---|
partnerId | string ( int64 format) مورد نیاز. شناسه شریکی که از طریق آن به فعالیت های Floodlight دسترسی پیدا می شود. |
pageSize | integer اختیاری. اندازه صفحه درخواستی باید بین 1 تا 100 باشد. اگر نامشخص باشد به طور پیش فرض 100 خواهد بود. اگر مقدار نامعتبری مشخص شده باشد، کد خطا INVALID_ARGUMENT را برمیگرداند. |
pageToken | string اختیاری. نشانه ای که صفحه ای از نتایجی را که سرور باید برگرداند، شناسایی کند. به طور معمول، این مقدار nextPageToken است که از فراخوانی قبلی به متد floodlightActivities.list برگردانده شده است. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. |
orderBy | string اختیاری. فیلدی که بر اساس آن لیست مرتب می شود. مقادیر قابل قبول عبارتند از: -
displayName (پیشفرض) -
floodlightActivityId
ترتیب مرتب سازی پیش فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، پسوند "desc" باید به نام فیلد اضافه شود. مثال: displayName desc . |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"floodlightActivities": [
{
object (FloodlightActivity )
}
],
"nextPageToken": string
} |
فیلدها |
---|
floodlightActivities[] | object ( FloodlightActivity ) لیست فعالیت های Floodlight. در صورت خالی بودن این لیست وجود نخواهد داشت. |
nextPageToken | string نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت pageToken در فراخوانی بعدی به متد floodlightActivities.list ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],["This document details how to list Floodlight activities within a specified Floodlight group using the Display & Video 360 API v4. The `GET` request requires the `floodlightGroupId` and `partnerId` as mandatory parameters. Optional parameters include `pageSize`, `pageToken`, and `orderBy` for pagination and sorting. The response includes a list of `floodlightActivities` and a `nextPageToken` for subsequent page retrieval. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope. The request body must be empty.\n"],null,["# Method: floodlightGroups.floodlightActivities.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListFloodlightActivitiesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists Floodlight activities in a Floodlight group.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/floodlightGroups/{floodlightGroupId}/floodlightActivities`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `floodlightGroupId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent Floodlight group to which the requested Floodlight activities belong. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the partner through which the Floodlight activities are being accessed. |\n| `pageSize` | `integer` Optional. Requested page size. Must be between `1` and `100`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\n| `pageToken` | `string` Optional. A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities/list#body.ListFloodlightActivitiesResponse.FIELDS.next_page_token) returned from the previous call to `floodlightActivities.list` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Optional. Field by which to sort the list. Acceptable values are: - `displayName` (default) - `floodlightActivityId` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"floodlightActivities\": [ { object (/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities#FloodlightActivity) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `floodlightActivities[]` | `object (`[FloodlightActivity](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities#FloodlightActivity)`)` The list of Floodlight activities. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `floodlightActivities.list` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]