Eine Ressource vom Typ i18nRegion
gibt ein geografisches Gebiet an, das ein YouTube-Nutzer als bevorzugter Inhaltsbereich auswählen kann. Der Inhaltsbereich kann auch als Inhaltssprache bezeichnet werden. Für die YouTube-Website kann automatisch ein Inhaltsbereich basierend auf Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers ausgewählt werden. Ein Nutzer kann den gewünschten Inhaltsbereich auch manuell in der Fußzeile der YouTube-Website auswählen.
Jede i18nRegion
-Ressource gibt einen Regionscode und einen Namen an. Der Regionscode kann beim Aufrufen von API-Methoden wie search.list
, videos.list
, activities.list
und videoCategories.list
als Wert für den Parameter regionCode
verwendet werden.
Methoden
Die API unterstützt die folgenden Methoden für i18nRegions
-Ressourcen:
- list
- Gibt eine Liste der Inhaltsbereiche zurück, die von der YouTube-Website unterstützt werden. Hier kannst du die Funktion ausprobieren.
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer i18nRegions
-Ressource:
{ "kind": "youtube#i18nRegion", "etag": etag, "id": string, "snippet": { "gl": string, "name": string } }
Attribute
In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#i18nRegion . |
etag |
etag Das ETag dieser Ressource. |
id |
string Die ID, mit der YouTube die Region i18n eindeutig identifiziert. |
snippet |
object Das Objekt snippet enthält grundlegende Details zur Region i18n, z. B. den Regionscode und den Namen. |
snippet.gl |
string Der aus zwei Buchstaben bestehende ISO-Ländercode zur Identifizierung der Region. |
snippet.name |
string Der Name der Region. |