I18nRegions

Eine i18nRegion-Ressource identifiziert einen geografischen Bereich, den ein YouTube-Nutzer als bevorzugte Inhaltsregion auswählen kann. Die Inhaltsregion kann auch als Inhaltslokalisierung bezeichnet werden. Für die YouTube-Website kann eine Inhaltsregion automatisch anhand von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers 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. Die Regionscodes können 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 sind die Eigenschaften aufgeführt, 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 snippet-Objekt enthält grundlegende Details zur I18N-Region, z. B. die Regionscodes und den Namen.
snippet.gl string
Der zweistellige ISO-Ländercode, der die Region angibt.
snippet.name string
Der Name der Region.