Aktualizujemy interfejs Data API, aby był zgodny ze sposobem zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
GuideCategories: list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Uwaga: to jest ogłoszenie o wycofaniu.
Zasób guideCategories i metoda guideCategories.list zostały wycofane 9 września 2020 r.
Zwraca listę kategorii, które można powiązać z kanałami w YouTube.
Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu w wysokości 1 jednostki.
Żądanie
Żądanie HTTP
GET https://www.googleapis.com/youtube/v3/guideCategories
Parametry
W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry to parametry zapytania.
| Parametry |
| Parametry wymagane |
part |
string
Parametr part określa właściwości zasobu guideCategory, które będą uwzględnione w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.
|
| Filtry(określ dokładnie jeden z tych parametrów) |
id |
string
Parametr id określa rozdzieloną przecinkami listę identyfikatorów kategorii kanałów w YouTube dla pobieranych zasobów. W zasobie guideCategory właściwość id określa identyfikator kategorii kanału w YouTube. |
regionCode |
string
Parametr regionCode nakazuje interfejsowi API zwrócenie listy kategorii przewodników dostępnych w określonym kraju. Wartością parametru jest kod kraju w formacie ISO 3166-1 alpha-2. |
| Parametry opcjonalne |
hl |
string
Parametr hl określa język, który będzie używany w przypadku wartości tekstowych w odpowiedzi interfejsu API. Wartością domyślną jest en-US. |
Treść żądania
Podczas wywoływania tej metody nie podawaj treści żądania.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:
{
"kind": "youtube#guideCategoryListResponse",
"etag": etag,
"nextPageToken": string,
"prevPageToken": string,
"pageInfo": {
"totalResults": integer,
"resultsPerPage": integer
},
"items": [
guideCategory resource
]
}
Właściwości
Poniższa tabela zawiera definicje właściwości, które pojawiają się w tym zasobie:
| Właściwości |
kind |
string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#guideCategoryListResponse. |
etag |
etag
Tag ETag tego zasobu. |
nextPageToken |
string
Token, którego można użyć jako wartości parametru pageToken, aby pobrać następną stronę w zbiorze wyników. |
prevPageToken |
string
Token, którego można użyć jako wartości parametru pageToken, aby pobrać poprzednią stronę w zbiorze wyników. |
pageInfo |
object
Obiekt pageInfo zawiera informacje o stronicowaniu zestawu wyników. |
pageInfo.totalResults |
integer
Łączna liczba wyników w zbiorze wyników. |
pageInfo.resultsPerPage |
integer
Liczba wyników uwzględnionych w odpowiedzi interfejsu API. |
items[] |
list
Lista kategorii, które można powiązać z kanałami w YouTube. W tej mapie identyfikator kategorii jest kluczem mapy, a jego wartością jest odpowiedni zasób guideCategory. |
Błędy
W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatu o błędzie.
| Typ błędu |
Szczegóły błędu |
Opis |
notFound (404) |
notFound |
Nie można znaleźć kategorii przewodnika określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody guideCategories.list. |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i zobaczyć żądanie oraz odpowiedź.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-22 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-22 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eguideCategories\u003c/code\u003e resource and \u003ccode\u003eguideCategories.list\u003c/code\u003e method have been deprecated as of September 9, 2020.\u003c/p\u003e\n"],["\u003cp\u003eThis API method, when functional, returned a list of categories associated with YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eA call to this method has a quota cost of 1 unit.\u003c/p\u003e\n"],["\u003cp\u003eThe API request requires the \u003ccode\u003epart\u003c/code\u003e parameter with the value \u003ccode\u003esnippet\u003c/code\u003e, and either the \u003ccode\u003eid\u003c/code\u003e or \u003ccode\u003eregionCode\u003c/code\u003e as a filtering parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe method's response, when functional, included properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003enextPageToken\u003c/code\u003e, \u003ccode\u003eprevPageToken\u003c/code\u003e, and \u003ccode\u003epageInfo\u003c/code\u003e, along with a list of \u003ccode\u003eguideCategory\u003c/code\u003e resources in the \u003ccode\u003eitems\u003c/code\u003e property.\u003c/p\u003e\n"]]],["The `guideCategories` resource and `guideCategories.list` method were deprecated on September 9, 2020. This method previously returned a list of YouTube channel categories. Key parameters included `part` (specifying properties), `id` (category IDs), and `regionCode` (country-specific categories). The method had a quota cost of 1 unit and did not use a request body. A successful response included metadata like `kind`, `etag`, `pageInfo`, and a list of `guideCategory` resources.\n"],null,["# GuideCategories: list\n\n**Note:** This is a deprecation announcement. \n\nThe `guideCategories` resource and the `guideCategories.list` method have both been deprecated as of September 9, 2020.\nReturns a list of categories that can be associated with YouTube channels.\n\n**Quota impact:** A call to this method has a [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/guideCategories\n```\n\n### Parameters\n\nThe table below 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 `guideCategory` resource properties that the API response will include. Set the parameter value to `snippet`. |\n| **Filters (specify exactly one of the following parameters)** |||\n| `id` | `string` The **id** parameter specifies a comma-separated list of the YouTube channel category ID(s) for the resource(s) that are being retrieved. In a `guideCategory` resource, the `id` property specifies the YouTube channel category ID. |\n| `regionCode` | `string` The **regionCode** parameter instructs the API to return the list of guide categories available in the specified country. The parameter value is an [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm) country code. |\n| **Optional parameters** |||\n| `hl` | `string` The **hl** parameter specifies the language that will be used for text values in the API response. The default value is `en-US`. |\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#guideCategoryListResponse\",\n \"etag\": etag,\n \"nextPageToken\": string,\n \"prevPageToken\": string,\n \"pageInfo\": {\n \"totalResults\": integer,\n \"resultsPerPage\": integer\n },\n \"items\": [\n guideCategory 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#guideCategoryListResponse`. |\n| `etag` | `etag` The Etag of this resource. |\n| `nextPageToken` | `string` The token that can be used as the value of the `pageToken` parameter to retrieve the next page in the result set. |\n| `prevPageToken` | `string` The token that can be used as the value of the `pageToken` parameter to retrieve the previous page in the result set. |\n| `pageInfo` | `object` The `pageInfo` object encapsulates paging information for the result set. |\n| pageInfo.`totalResults` | `integer` The total number of results in the result set. |\n| pageInfo.`resultsPerPage` | `integer` The number of results included in the API response. |\n| `items[]` | `list` A list of categories that can be associated with YouTube channels. In this map, the category ID is the map key, and its value is the corresponding `guideCategory` resource. |\n\nErrors\n------\n\nThe table below 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| `notFound (404)` | `notFound` | The guide category identified by the `id` parameter cannot be found. Use the [guideCategories.list](/youtube/v3/docs/guideCategories/list) method to retrieve a list of valid values. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
