I18nRegions

Eine i18nRegion-Ressource gibt ein geografisches Gebiet an, das ein YouTube-Nutzer als bevorzugte Inhaltsregion auswählen kann. Der Inhaltsbereich kann auch als Inhaltsgebietsschema bezeichnet werden. Für die YouTube-Website kann auf Grundlage von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch eine Region ausgewählt werden. Nutzer können die gewünschte Inhaltsregion auch manuell in der Fußzeile der YouTube-Website auswählen.

Jede i18nRegion-Ressource identifiziert einen Regionscode und einen Namen. Der Regionscode kann als Wert des Parameters regionCode verwendet werden, wenn API-Methoden wie search.list, videos.list, activities.list und videoCategories.list aufgerufen werden.

Methoden

Die API unterstützt die folgenden Methoden für i18nRegions-Ressourcen:

list
Gibt eine Liste der Inhaltsregionen 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 i18n-Region eindeutig identifiziert.
snippet object
Das Objekt snippet enthält grundlegende Details zur i18n-Region, z. B. den Regionscode und den Namen.
snippet.gl string
Der aus zwei Buchstaben bestehende ISO-Ländercode für die Region.
snippet.name string
Der Name der Region.