Mulai 8 September 2025, setiap item baris baru harus menyatakan apakah item baris tersebut akan menayangkan iklan politik Uni Eropa (EU) atau tidak. Upload SDF dan API Display & Video 360 yang tidak memberikan pernyataan akan gagal. Lihat halaman penghentian penggunaan kami untuk mengetahui detail selengkapnya tentang cara memperbarui integrasi Anda untuk membuat pernyataan ini.
Wajib. ID channel induk yang memiliki situs yang diminta.
Parameter gabungan owner. Wajib. Mengidentifikasi entity DV360 yang memiliki channel induk. Pihak tersebut dapat berupa partner atau pengiklan. owner hanya dapat berupa salah satu dari berikut:
Ukuran halaman yang diminta. Harus antara 1 dan 10000. Jika tidak ditentukan, defaultnya adalah 100. Menampilkan kode error INVALID_ARGUMENT jika nilai yang tidak valid ditentukan.
pageToken
string
Token yang mengidentifikasi halaman hasil yang harus ditampilkan server.
Biasanya, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode sites.list. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.
orderBy
string
Kolom yang akan digunakan untuk mengurutkan daftar. Nilai yang dapat diterima adalah:
urlOrAppId (default)
Urutan pengurutan default adalah menaik. Untuk menentukan urutan menurun untuk kolom, akhiran "desc" harus ditambahkan ke nama kolom. Contoh: urlOrAppId desc.
filter
string
Memungkinkan pemfilteran menurut kolom situs.
Sintaksis yang didukung:
Ekspresi filter untuk pengambilan situs hanya dapat berisi maksimal satu batasan.
Pembatasan memiliki bentuk {field} {operator} {value}.
Semua kolom harus menggunakan operator HAS (:).
Kolom yang didukung:
urlOrAppId
Contoh:
Semua situs yang URL atau ID aplikasinya berisi "google": urlOrAppId : "google"
Panjang kolom ini tidak boleh lebih dari 500 karakter.
Parameter gabungan owner. Wajib. Mengidentifikasi entity DV360 yang memiliki channel induk. Pihak tersebut dapat berupa partner atau pengiklan. owner hanya dapat berupa salah satu dari berikut:
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003eLists sites associated with a given channel within a Display & Video 360 advertiser or partner.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering and sorting of sites based on criteria like URL or app ID.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large lists of sites efficiently.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document outlines the process for listing sites within a channel using the Display & Video 360 API. Key actions include sending a `GET` request to a specified URL, which requires the `channelId` and either `advertiserId` or `partnerId` as path parameters. Optional query parameters, such as `pageSize`, `pageToken`, `orderBy`, and `filter`, refine the list results. The request body must be empty, and successful responses contain a `ListSitesResponse`. API authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: advertisers.channels.sites.list\n\n| Display \\& Video 360 API v2 has sunset.\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists sites in a channel.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/channels/{channelId}/sites`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `channelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent channel to which the requested sites belong. |\n| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent channel. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v2/ListSitesResponse#FIELDS.next_page_token) returned from the previous call to `sites.list` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `urlOrAppId` (default) The default sorting order is ascending. To specify descending order for a field, a suffix \" desc\" should be added to the field name. Example: `urlOrAppId desc`. |\n| `filter` | `string` Allows filtering by site fields. Supported syntax: - Filter expressions for site retrieval can only contain at most one restriction. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `HAS (:)` operator. Supported fields: - `urlOrAppId` Examples: - All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information. |\n| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent channel. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListSitesResponse](/display-video/api/reference/rest/v2/ListSitesResponse).\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](https://developers.google.com/identity/protocols/OAuth2)."]]
