Kami memperbarui Data API agar sesuai dengan cara YouTube menghitung penayangan untuk Shorts.
Pelajari lebih lanjut
MembershipsLevels: list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Catatan: Endpoint ini hanya dapat digunakan oleh masing-masing kreator untuk membuat permintaan untuk channel YouTube mereka sendiri yang mengaktifkan langganan channel. Hubungi perwakilan Google atau YouTube Anda untuk meminta akses.
Mencantumkan level langganan untuk channel yang memberikan otorisasi permintaan. Level ditampilkan dalam urutan tampilan implisit. Permintaan API ke metode ini menghasilkan salah satu respons berikut:
- Jika kreator telah mengaktifkan langganan channel dan memiliki level harga, respons API akan berisi daftar level.
- Jika kreator telah mengaktifkan langganan channel tetapi belum menentukan tingkat harga, respons API akan berisi daftar kosong.
- Jika kreator belum mengaktifkan langganan channel, API akan menampilkan error
channelMembershipsNotEnabled.
Dampak kuota: Panggilan ke metode ini memiliki biaya kuota sebesar 1 unit.
Permintaan
Permintaan HTTP
GET https://www.googleapis.com/youtube/v3/membershipsLevels
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
| Cakupan |
|---|
https://www.googleapis.com/auth/youtube.channel-memberships.creator |
Parameter
Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.
| Parameter |
| Parameter yang diperlukan |
part |
string
Parameter part menentukan properti resource membershipsLevel
yang akan disertakan dalam respons API. Parameter value adalah daftar bagian resource yang dipisahkan koma. Daftar berikut menunjukkan bagian yang dapat
diambil:
|
Isi permintaan
Jangan berikan isi permintaan saat memanggil metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{
"kind": "youtube#membershipsLevelListResponse",
"etag": etag,
"items": [
membershipsLevel Resource
]
}
Properti
Tabel berikut mendefinisikan properti yang muncul di resource ini:
| Properti |
kind |
string
Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#membershipsLevelListResponse. |
etag |
etag
Etag resource ini. |
items[] |
list
Daftar membershipsLevel resource yang dimiliki oleh channel yang mengizinkan permintaan API. |
Error
Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk detail selengkapnya.
| Jenis error |
Detail error |
Deskripsi |
badRequest (400) |
channelMembershipsNotEnabled |
Langganan channel tidak diaktifkan oleh channel kreator yang memberi otorisasi permintaan ini. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-04-26 UTC.
[null,null,["Terakhir diperbarui pada 2024-04-26 UTC."],[[["\u003cp\u003eThis API endpoint allows individual YouTube creators with channel memberships enabled to retrieve a list of their channel's membership levels.\u003c/p\u003e\n"],["\u003cp\u003eThe API response will either include a list of membership levels, an empty list if memberships are enabled but no levels are set, or an error if memberships are not enabled.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a JSON response containing the resource type, Etag, and a list of \u003ccode\u003emembershipsLevel\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this method have a quota cost of 1 unit and require authorization with the scope \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.channel-memberships.creator\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003epart\u003c/code\u003e parameter with a string value that can contain either \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003esnippet\u003c/code\u003e, or both, as comma separated values.\u003c/p\u003e\n"]]],["This API endpoint allows individual creators to retrieve channel membership levels for their YouTube channel. A `GET` request requires authorization with the `youtube.channel-memberships.creator` scope and the `part` parameter to specify the properties. The response, in JSON format, lists membership levels or an empty list if levels are undefined. If channel memberships aren't enabled, the API returns a `channelMembershipsNotEnabled` error. This method has a quota cost of 1 unit per call.\n"],null,["# MembershipsLevels: list\n\nNote: This endpoint can only be used by individual creators to make requests for their own, channel-memberships-enabled YouTube channel. Reach out to your Google or YouTube representative to request access.\n\nLists membership levels for the channel that authorized the request. Levels are returned in\nimplicit display order. API requests to this method yield one of the following responses:\n\n- If the creator has enabled channel memberships and has pricing levels, then the API response contains the list of levels.\n- If the creator has enabled channel memberships but has not defined pricing levels, then the API response contains an empty list.\n- If the creator has not enabled channel memberships, the API returns a [channelMembershipsNotEnabled](#errors) error.\n\n**Quota impact:** A call to this method has a\n[quota cost](/youtube/v3/getting-started#quota) of 1 unit.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/youtube/v3/membershipsLevels\n```\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/youtube.channel-memberships.creator` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter specifies the `membershipsLevel` resource properties that the API response will include. The parameter value is a comma-separated list of resource parts. The following list shows the parts that can be retrieved: - `id` - `snippet` |\n\n### Request body\n\nDo not provide a request body when calling 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\": \"youtube#membershipsLevelListResponse\",\n \"etag\": etag,\n \"items\": [\n membershipsLevel Resource\n ]\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|-----------|--------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#membershipsLevelListResponse`. |\n| `etag` | `etag` The Etag of this resource. |\n| `items[]` | `list` A list of `membershipsLevel` resources owned by the channel that authorized the API request. |\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. Please see the [error message](/youtube/v3/docs/errors) documentation for more detail.\n\n| Error type | Error detail | Description |\n|--------------------|--------------------------------|----------------------------------------------------------------------------------------|\n| `badRequest (400)` | `channelMembershipsNotEnabled` | The creator channel authorizing the request does not have channel memberships enabled. |"]]
