ReportTypes

Eine reportType-Ressource gibt einen bestimmten Bericht an, den ein Kanal oder Rechteinhaber abrufen kann.

Methoden

In der folgenden Tabelle sind die Methoden aufgeführt, die von der API für report-Ressourcen unterstützt werden.

Methoden
list	Gibt eine Liste der Berichtstypen zurück, die der Kanal- oder Rechteinhaber abrufen kann.

JSON-Ressourcendarstellung

Die JSON-Struktur unten zeigt das Format einer reportType-Ressource:

{
  "id": string,
  "name": string,
  "deprecateTime": timestamp,
  "systemManaged": boolean
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Attribute
id	string Die ID, die YouTube zur eindeutigen Identifizierung des Berichts verwendet. Der Eigenschaftswert darf maximal 100 Zeichen lang sein. In der folgenden Tabelle finden Sie die jeweils aktuelle Version der einzelnen unterstützten Berichtstypen (max. 100 Zeichen). Unterstützte Berichte für Channels ansehen Berichts-ID Beschreibung channel_basic_a2 Nutzeraktivität channel_province_a2 Nutzeraktivität nach Bundesland channel_playback_location_a2 Wiedergabeorte channel_traffic_source_a2 Zugriffsquellen channel_device_os_a2 Gerät und Betriebssystem channel_demographics_a1 Demografische Merkmale channel_sharing_service_a1 Freigabedienste channel_annotations_a1 Annotationen channel_cards_a1 Karten channel_end_screens_a1 Abspanne channel_subtitles_a2 Untertitel channel_combined_a2 Kombiniert audience_retention_a1 Zuschauerbindung bei Videos playlist_basic_a1 Nutzeraktivität bei Playlists playlist_province_a1 Nutzeraktivität bei Playlists nach Bundesland playlist_playback_location_a1 Wiedergabeorte von Playlists playlist_traffic_source_a1 Zugriffsquellen aus Playlists playlist_device_os_a1 Gerät und Betriebssystem für die Playlist playlist_combined_a1 Playlist kombiniert Unterstützte Berichte für Rechteinhaber Berichts-ID Beschreibung content_owner_basic_a3 Nutzeraktivität content_owner_province_a2 Nutzeraktivität nach Bundesland content_owner_playback_location_a2 Wiedergabeorte content_owner_traffic_source_a2 Zugriffsquellen content_owner_device_os_a2 Gerät und Betriebssystem content_owner_demographics_a1 Demografische Merkmale content_owner_sharing_service_a1 Freigabedienste content_owner_annotations_a1 Annotationen content_owner_cards_a1 Karten content_owner_end_screens_a1 Abspanne content_owner_subtitles_a2 Untertitel content_owner_combined_a2 Kombiniert content_owner_playlist_basic_a1 Nutzeraktivität bei Playlists content_owner_playlist_province_a1 Nutzeraktivität bei Playlists nach Bundesland content_owner_playlist_playback_location_a1 Wiedergabeorte von Playlists content_owner_playlist_traffic_source_a1 Zugriffsquellen aus Playlists content_owner_playlist_device_os_a1 Gerät und Betriebssystem für die Playlist content_owner_playlist_combined_a1 Playlist kombiniert content_owner_ad_rates_a1 Anzeigenleistung content_owner_estimated_revenue_a1 Geschätzter Umsatz nach Video content_owner_asset_estimated_revenue_a1 Geschätzter Umsatz nach Asset content_owner_asset_basic_a2 Nutzeraktivität für Assets content_owner_asset_province_a2 Nutzeraktivität nach Bundesland für Assets content_owner_asset_playback_location_a2 Wiedergabeorte von Assets content_owner_asset_traffic_source_a2 Traffic-Quellen für Assets content_owner_asset_device_os_a2 Asset-Gerät und ‑Betriebssystem content_owner_asset_demographics_a1 Demografische Merkmale von Assets content_owner_asset_sharing_service_a1 Dienste zum Teilen von Assets content_owner_asset_annotations_a1 Asset-Anmerkungen content_owner_asset_cards_a1 Asset-Karten content_owner_asset_end_screens_a1 Asset-Abspanne content_owner_asset_combined_a2 Asset kombiniert Unterstützte vom System verwaltete Berichte (für Rechteinhaber) Berichts-ID Beschreibung content_owner_ad_revenue_raw_a1 Detaillierte Werbeeinnahmen pro Video content_owner_ad_revenue_summary_a1 Gesamte Werbeeinnahmen pro Video content_owner_asset_ad_revenue_raw_a1 Detaillierte Werbeeinnahmen pro Asset content_owner_asset_ad_revenue_summary_a1 Gesamte Werbeeinnahmen pro Asset content_owner_claim_ad_revenue_summary_a1 Ansprüche (dieser Bericht enthält keine Umsatzdaten)
name	string Der Name des Berichts. Der Eigenschaftswert darf maximal 100 Zeichen lang sein.
deprecateTime	timestamp Das Datum und die Uhrzeit, zu der der Bericht eingestellt wurde oder wird. Wenn Sie einen Job für einen eingestellten Berichtstyp haben, generiert YouTube für diesen Job drei Monate nach dem angekündigten Einstellungsdatum neue Berichte. Die Einstellung des Berichts content_owner_basic_a1 wurde beispielsweise am 19. Mai 2016 angekündigt. Das Feld deprecateTime für diesen Berichtstyp gibt also einen Zeitpunkt am 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr erstellt.
systemManaged	boolean Dieser Wert ist true, wenn YouTube den Bericht automatisch für YouTube-Rechteinhaber generiert, ohne dass diese zuerst die Methode jobs.create aufrufen müssen, um YouTube anzuweisen, den Bericht zu generieren. Tatsächlich gibt die Methode jobs.create einen Fehler zurück, wenn die Property reportTypeId einen vom System verwalteten Bericht identifiziert.