Nous mettons à jour l'API Data pour qu'elle corresponde à la façon dont YouTube comptabilise les vues des Shorts.
En savoir plus
GuideCategories
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Remarque : Il s'agit d'une annonce d'abandon.
La ressource guideCategories et la méthode guideCategories.list sont toutes deux obsolètes depuis le 9 septembre 2020.
Une ressource guideCategory identifie une catégorie que YouTube attribue de manière algorithmique en fonction du contenu d'une chaîne ou d'autres indicateurs, comme sa popularité. Cette liste est semblable aux catégories de vidéos, à une différence près : l'utilisateur qui a mis en ligne une vidéo peut en attribuer une, mais seul YouTube peut en attribuer une.
Méthodes
L'API accepte les méthodes suivantes pour les ressources guideCategories:
- liste
- Renvoie une liste de catégories pouvant être associées à des chaînes YouTube.
Essayer
Représentation des ressources
La structure JSON ci-dessous montre le format d'une ressource guideCategories:
{
"kind": "youtube#guideCategory",
"etag": etag,
"id": string,
"snippet": {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"title": string
}
}
Propriétés
Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:
| Propriétés |
kind |
string
Identifie le type de la ressource de l'API. La valeur sera youtube#guideCategory. |
etag |
etag
ETag de cette ressource. |
id |
string
ID utilisé par YouTube pour identifier de façon unique la catégorie du guide. |
snippet |
object
L'objet snippet contient des informations de base sur la catégorie, comme son titre. |
snippet.channelId |
string
ID utilisé par YouTube pour identifier de façon unique la chaîne qui publie la catégorie du guide. |
snippet.title |
string
Titre de la catégorie. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
