Estamos atualizando a API Data para corresponder à forma como o YouTube conta as visualizações dos Shorts.
Saiba mais
GuideCategories
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Observação:este é um anúncio de descontinuação.
O recurso guideCategories
e guideCategories.list
foram descontinuados em 9 de setembro de 2020.
Um recurso guideCategory
identifica uma categoria que o YouTube atribui de forma algorítmica com base no conteúdo de um canal ou em outros indicadores, como a popularidade dele. A lista é semelhante a categorias de vídeo, com a diferença de que o usuário que fez o envio de um vídeo pode atribuir uma categoria de vídeo, mas somente o YouTube pode atribuir uma categoria de canal.
Métodos
A API oferece suporte aos seguintes métodos para recursos guideCategories
:
- list
- Retorna uma lista de categorias que podem ser associadas a canais do YouTube.
Faça um teste agora.
Representação de recurso
A estrutura JSON abaixo mostra o formato de um recurso guideCategories
:
{
"kind": "youtube#guideCategory",
"etag": etag,
"id": string,
"snippet": {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"title": string
}
}
Propriedades
A tabela a seguir define as propriedades que aparecem neste recurso:
Propriedades |
kind |
string
Identifica o tipo de recurso da API. O valor será youtube#guideCategory . |
etag |
etag
A Etag deste recurso. |
id |
string
O ID que o YouTube usa para identificar de forma exclusiva a categoria do guia. |
snippet |
object
O objeto snippet contém detalhes básicos sobre a categoria, como o título. |
snippet.channelId |
string
O ID que o YouTube usa para identificar de forma exclusiva o canal que publica a categoria do guia. |
snippet.title |
string
O título da categoria. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eguideCategories\u003c/code\u003e resource and \u003ccode\u003eguideCategories.list\u003c/code\u003e method were deprecated on September 9, 2020.\u003c/p\u003e\n"],["\u003cp\u003eA guide category is a classification assigned by YouTube to a channel based on its content or other indicators.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eguideCategories.list\u003c/code\u003e method provided a list of categories applicable to YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eguideCategory\u003c/code\u003e resource contains an ID, a snippet with basic details like a title, and other metadata such as the category's etag.\u003c/p\u003e\n"],["\u003cp\u003eUnlike video categories that are assigned by uploaders, channel categories are exclusively assigned by YouTube.\u003c/p\u003e\n"]]],["The `guideCategories` resource and its `list` method were deprecated on September 9, 2020. A `guideCategory` represents a YouTube-assigned category for a channel. The `list` method previously returned categories associated with YouTube channels. The resource's JSON structure included `kind`, `etag`, `id`, and a `snippet` object with `channelId` and `title` properties. Only YouTube could assign these categories, unlike video categories, which could be assigned by the uploader.\n"],null,["# GuideCategories\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.\nA **guideCategory** resource identifies a category that YouTube algorithmically assigns based on a channel's content or other indicators, such as the channel's popularity. The list is similar to [video categories](/youtube/v3/docs/videoCategories), with the difference being that a video's uploader can assign a video category but only YouTube can assign a channel category.\n\nMethods\n-------\n\nThe API supports the following methods for `guideCategories` resources:\n\n[list](/youtube/v3/docs/guideCategories/list)\n: Returns a list of categories that can be associated with YouTube channels.\n [Try it now](/youtube/v3/docs/guideCategories/list#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `guideCategories` resource: \n\n```text\n{\n \"kind\": \"youtube#guideCategory\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"title\": string\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#guideCategory`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the guide category. |\n| `snippet` | `object` The `snippet` object contains basic details about the category, such as its title. |\n| snippet.`channelId` | `string` The ID that YouTube uses to uniquely identify the channel publishing the guide category. |\n| snippet.`title` | `string` The category's title. |"]]