2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 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 グループの ID。
|
クエリ パラメータ
パラメータ |
partnerId |
string (int64 format)
必須。Floodlight アクティビティにアクセスするパートナーの ID。
|
pageSize |
integer
省略可。リクエストされたページサイズです。 1 ~100 の範囲で指定してください。指定しない場合、デフォルトの 100 が使用されます。無効な値が指定されている場合は、エラーコード INVALID_ARGUMENT を返します。
|
pageToken |
string
省略可。サーバーが返す必要がある結果のページを特定するトークンです。 通常、これは floodlightActivities.list メソッドの前の呼び出しから返された nextPageToken の値です。指定しない場合、結果の最初のページが返されます。
|
orderBy |
string
省略可。リストの並べ替え基準として使用するフィールド。有効な値は次のとおりです。
displayName (デフォルト)
floodlightActivityId
デフォルトの並べ替え順序は昇順です。フィールドに対して降順を指定するには、フィールド名に接尾辞「desc」を追加する必要があります。例: displayName desc 。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
{
"floodlightActivities": [
{
object (FloodlightActivity )
}
],
"nextPageToken": string
} |
フィールド |
floodlightActivities[] |
object (FloodlightActivity )
Floodlight アクティビティのリスト。 空の場合は、このリストは表示されません。
|
nextPageToken |
string
結果の次のページを取得するためのトークン。 この値を次の floodlightActivities.list メソッド呼び出しの pageToken フィールドで渡して、結果の次ページを取得します。
|
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],["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)."]]