YouTube Analytics Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.

Erste Schritte

Versionsunterstützung für YouTube Analytics

Der Connector verwendet Version 2 der YouTube Analytics API.

Herstellen einer Verbindung

Mit YouTube Analytics verbinden

YouTube Analytics unterstützt nur die OAuth-Authentifizierung. Um diese Authentifizierung für alle OAuth-Flows zu aktivieren, müssen Sie Folgendes festlegen: AuthScheme Zu OAuth.

In den folgenden Unterabschnitten wird die Authentifizierung bei YouTube Analytics über drei gängige Authentifizierungsabläufe beschrieben:

• Desktop: eine Verbindung zu einem Server auf dem lokalen Computer des Benutzers, die häufig zum Testen und Prototyping verwendet wird. Authentifiziert entweder über eingebettetes OAuth oder benutzerdefiniertes OAuth.
• Web: Zugriff auf Daten über eine gemeinsam genutzte Website. Authentisierung nur über benutzerdefiniertes OAuth.
• Headless Server: ein dedizierter Computer, der anderen Computern und ihren Benutzern Dienste bereitstellt und so konfiguriert ist, dass er ohne Monitor und Tastatur funktioniert. Authentifiziert über eingebettetes OAuth oder benutzerdefiniertes OAuth.

Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung und warum Sie möglicherweise eine solche sogar für Authentifizierungsabläufe mit eingebetteten OAuth-Anmeldeinformationen erstellen möchten, finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Eine vollständige Liste der in YouTube Analytics verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Verbindung.

Desktop-Anwendungen

bietet eine eingebettete OAuth-Anwendung, die die Authentifizierung auf dem Desktop vereinfacht, d. h. in Situationen, in denen der Benutzer einen lokalen Server verwendet, der nicht mit dem Internet verbunden ist.

Sie können sich auch vom Desktop aus über eine benutzerdefinierte OAuth-Anwendung authentifizieren, die Sie in der YouTube Analytics Konsole konfigurieren und registrieren. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Legen Sie vor dem Verbinden die folgenden Variablen fest:

• InitiateOAuth = GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken.
• Custom OAuth applications only:
  • OAuthClientId = die Client-ID, die Ihnen bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung zugewiesen wurde.
  • OAuthClientSecret = das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung zugewiesen wurde.
  • CallbackURL = die Umleitungs-URI, die bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung definiert wurde.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von YouTube Analytics in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen.

Nachdem Sie der Anwendung Berechtigungen erteilt haben, schließt der Connector den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von YouTube Analytics und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden im in angegebenen Pfad gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Wenn das Zugriffstoken abläuft, aktualisiert der Connector es automatisch.

Automatische Aktualisierung des OAuth-Zugriffstokens:

Damit der Connector das OAuth-Zugriffstoken automatisch aktualisiert, gehen Sie wie folgt vor:

1. Wenn Sie zum ersten Mal eine Verbindung zu Daten herstellen, legen Sie die folgenden Verbindungsparameter fest:
   • InitiateOAuth = REFRESH.
   • OAuthClientId = die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret = das Client-Geheimnis in Ihren Anwendungseinstellungen.
   • OAuthAccessToken = der von GetOAuthAccessToken zurückgegebene Zugriffstoken.
   • OAuthSettingsLocation = der Pfad, in dem der Connector die OAuth-Werte speichern soll, die über Verbindungen hinweg bestehen bleiben.
2. Legen Sie bei nachfolgenden Datenverbindungen Folgendes fest:
   • InitiateOAuth
   • OAuthSettingsLocation

Manuelle Aktualisierung des OAuth-Zugriffstokens:

Der einzige Wert, der zur manuellen Aktualisierung des OAuth-Zugriffstokens benötigt wird, ist das OAuth-Aktualisierungstoken.

1. Um das OAuthAccessToken nach dem ExpiresIn-Zeitraum (zurückgegeben von GetOAuthAccessToken manuell zu aktualisieren) abgelaufen ist, rufen Sie den RefreshOAuthAccessToken gespeicherte Prozedur.
2. Legen Sie die folgenden Verbindungseigenschaften fest:
   • OAuthClientId = die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret = das Client Secret in Ihren Anwendungseinstellungen.
3. Rufen Sie RefreshOAuthAccessToken auf mit OAuthRefreshToken auf das von GetOAuthAccessToken zurückgegebene OAuth-Aktualisierungstoken gesetzt.
4. Nachdem die neuen Token abgerufen wurden, setzen Sie das OAuthAccessTokenEigenschaft auf den von RefreshOAuthAccessToken zurückgegebenen Wert. Dadurch wird eine neue Verbindung geöffnet.

Speichern Sie das OAuth-Aktualisierungstoken, damit Sie es verwenden können, um das OAuth-Zugriffstoken nach Ablauf manuell zu aktualisieren.

Erstellen einer benutzerdefinierten OAuth-Anwendung

Das Einrichten der OAuth-Authentifizierung erfordert einige Vorkonfigurationen. Sobald das Benutzerkonto, das Dienstkonto oder das GCP-Instanzkonto richtig konfiguriert ist, ist es bereit zur Verbindung.

Benutzerkonten

In diesem Abschnitt wird beschrieben, wie Sie eine benutzerdefinierte OAuth-Anwendung registrieren und die OAuthClientId Und OAuthClientSecret für Benutzerkonten.

Desktop

So registrieren Sie eine App und erhalten die OAuth-Clientanmeldeinformationen:

1. Melden Sie sich bei der Google API Konsole an.
2. Öffnen Sie ein Projekt.
3. Wählen Sie im Hauptmenü den API-Manager aus.
4. Klicken Sie im Benutzereinwilligungsablauf auf Credentials > Create Credentials > OAuth Client Id.
5. Klicken Sie auf Other. Die Google API Konsole erstellt die benutzerdefinierte Anwendung und zeigt die OAuthClientId Und OAuthClientSecret.
6. Notieren Sie die OAuthClientId Und OAuthClientSecret zur späteren Verwendung.
7. Klicken Sie auf Library > YouTube Analytics API > Enable API.

Dienstkonten

Um eine OAuth-Anwendung zu erstellen, generieren Sie einen privaten Schlüssel und autorisieren Sie dann das Dienstkonto:

1. Melden Sie sich bei der Google API Konsole an.

2. Öffnen Sie ein Projekt.

3. Wählen Sie im Hauptmenü den API-Manager aus.

4. Klicken Sie im Benutzereinwilligungsablauf auf Credentials > Create Credentials > Service Account Key.

5. Wählen Sie im Menü „Dienstkonto“ entweder New Service Account (sofern zutreffend) oder ein bestehendes Service-Konto.

6. Wenn es sich um ein neues Dienstkonto handelt, wählen Sie eine oder mehrere Rollen aus. Sie können einfache Rollen auf Projektebene im

   IAM- und Admin-Bereich; andere Rollen ermöglichen Ihnen, den Zugriff auf Google APIs weiter anzupassen.

7. Wählen Sie im Abschnitt Schlüsseltyp P12.

8. Klicken Sie auf Create. Die Google API Konsole erstellt die benutzerdefinierte Anwendung und zeigt das Schlüsselpaar und das Kennwort für den privaten Schlüssel an.

9. Laden Sie das Schlüsselpaar herunter und legen Sie das Passwort des privaten Schlüssels in fest OAuthJWTCertPassword.

10. Klicken Sie im Menü „Dienstkonto“ auf Manage Service Accounts.

11. Satz OAuthJWTIssuer an die im angezeigte Email Adresse service account Id Feld.

12. Klicken Sie auf Library > YouTube Analytics API > Enable API.

GCP-Instanzkonten

Wenn der Connector auf einer virtuellen GCP-Maschine ausgeführt wird, kann er sich mithilfe eines an die virtuelle Maschine gebundenen Dienstkontos authentifizieren. Um diesen Modus zu verwenden, setzen Sie AuthScheme Zu GCPInstanceAccount.

Abrufen von YouTube Analytics Daten

YouTube Analytics Daten sind in verschiedene Metriken (Zuschauer, Zuschauerprozentsatz, Altersgruppe usw.) unterteilt, die über verschiedene Dimensionen (Tag, Gerätetyp usw.) abgefragt werden können. Es gibt viele gültige Kombinationen aus Metriken und Dimensionen. Der Connector stellt einige der am häufigsten verwendeten Kombinationen zur einfacheren Verwendung als relationale Ansichten dar.

Darüber hinaus können Sie mit dem Connector alle gültigen Kombinationen Abfrage, auch solche, die nicht in den vordefinierten Ansichten enthalten sind. Sie können das CreateCustomSchema gespeicherte Prozedur zum Erstellen einer Ansicht für eine Abfrage. Siehe Datenmodell zum Kombinieren von Metriken und Dimensionen in Abfragen und Schemata. Unten finden Sie eine Anleitung zum Einstieg in die Standardansichten.

Dimensionen und Kennzahlen auswählen {: #selecting-dimensions-and-measures}#### Ausführen von SELECT *-Abfragen

Die Dimension und Metriken sind für jede Tabelle klar definiert und können im Datenmodell eingesehen werden: Wählen Sie einfach die Kennzahlen und Dimensionen aus, die Sie interessieren. Die Top-Videos eines Kanals nach den meisten angesehen Minuten in einem bestimmten Land können beispielsweise wie folgt ausgewählt werden:

SELECT Video, Views, EstimatedMinutesWatched, AverageViewDuration, AverageViewPercentage FROM TopVideos WHERE Country='AL'

SELECT * Abfragen ausführen

Im Gegensatz zu den meisten Datenbanktabellen ist es nicht sehr hilfreich, alle Metriken und Dimensionen in einer bestimmten Tabelle auszuwählen. Der Connector interpretiert die SELECT *- Abfrage daher so, dass ein Standardsatz an Metriken und Dimensionen angefordert wird. Dies schließt Abfragen ein, die explizit alle Spalten auswählen. Weitere Informationen finden Sie in der Dokumentation der einzelnen Ansichten unter Datenmodell, um zu sehen, welche Felder für jedes Schema die Standardfelder sind.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des YouTube Analytics Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

Proxy

So konfigurieren Sie den Connector mithilfe von privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf YouTube Analytics und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Benutzerdefinierte Ansichten

Mit dem YouTube Analytics Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Ansichten mithilfe einer Konfigurationsdatei definieren

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei definiert namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Groups WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Ansichten mit DDL-Anweisungen definieren

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Eine Ansicht erstellen

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ansicht ändern

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Eine Ansicht löschen

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie UserViewsSchemaName-Eigenschaft.

Mit benutzerdefinierten Ansichten arbeiten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

Datenmodell

Der YouTube Analytics Connector modelliert YouTube Analytics Entitäten in relationalen Tabellen, Ansichten und gespeicherten Prozeduren.

YouTube Analytics ermöglicht die Abfrage von Dimensionen und Metriken in einer Vielzahl von Anordnungen. Wir bieten einige Beispielansichten basierend auf gängigen YouTube Analytics Berichten. Sie können auch Ihre eigenen benutzerdefinierten Ansichten basierend auf jeder beliebigen Kombination von Dimensionen und Metriken erstellen, die Sie benötigen.

Informationen zum Anzeigen von Schemas sowie zu API Einschränkungen und-Anforderungen finden Sie weiter unten unter Definieren benutzerdefinierter Ansichten.

Tabellen

Sie können auf Gruppen und Gruppenelemente als Tabellen zugreifen.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle, die verwendet werden können, um auf zusätzliche Funktionen der YouTube Analytics API zuzugreifen.

Ansichten

Berichte werden als Ansichten angezeigt, d. h. als Tabellen, die "Momentaufnahmen" der Daten sind und nicht geändert werden können. Im Gegensatz zu herkömmlichen Datenbankansichten ist es nicht sehr hilfreich, eine Ansicht einer gesamten Tabelle zu erstellen, indem alle Metriken und Dimensionen in dieser Tabelle ausgewählt werden, da der Anbieter die SELECT * Abfrage, als ob Sie einen Standardsatz von Metriken und Dimensionen anfordern würden. Dies gilt auch für Abfragen, die explizit alle Spalten auswählen.

Beachten Sie, dass die YouTube Analytics API die Anzahl und Kombinationen von Spalten begrenzt, die über die Daten projiziert oder zum Einschränken der zurückgegebenen Ergebnisse verwendet werden können. Diese Einschränkungen und die Standardfelder für jedes Schema sind in Ansichten aufgeführt. Beachten Sie diese Abschnitte auch, wenn Sie Ihre eigene Ansicht definieren.

Benutzerdefinierte Ansichten definieren

Verwenden Sie CreateCustomSchema gespeicherte Prozedur zum Erstellen einer Ansicht für eine Abfrage. Diese gespeicherte Prozedur bietet eine einfache Möglichkeit, neue Ansichtsdefinitionen mit einer benutzerdefinierten Kombination aus Dimensionen und Metriken zu generieren. Durch den Aufruf wird eine neue Schema erstellt, die Sie wie jede andere Ansicht Abfrage können.

Die gespeicherte Prozedur verwendet als Eingaben einen Ansichtsnamen, eine durch Kommas getrennte Liste von Metriken, eine durch Kommas getrennte Liste von Dimensionen und einen Ausgabeordner. Um auf die erstellten Script zuzugreifen, müssen Sie festlegen Location in den Ordner, der die neuen Script enthält. In diesem Sinne Location ist ein Ersatz für den Ausgabeordner.

Um beispielsweise ein neues Schema zusammen mit den Standardschemata zu verwenden, setzen Sie Location in den Unterordner db im Installationsordner und rufen Sie auf:

EXEC CreateCustomSchema Dimensions='Day,DeviceType', Metrics='Views,EstimatedMinutesWatched', TableName='DailyDeviceReports'

Tabellen

Der Connector modelliert die Daten in YouTube Analytics als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

YouTube Analytics Connector-Tabellen

Gruppierungselemente

Erstellen, löschen und Abfrage Elemente, die eine Gruppe bilden.

Tabellenspezifische Informationen

Auswählen

Die folgende Abfrage gibt die Elemente zurück, aus denen die YouTube Analytics Gruppen bestehen:

SELECT * FROM GroupItems

Die folgende Abfrage gibt die Elemente zurück, aus denen eine bestimmte YouTube Analytics Gruppe besteht:

SELECT * FROM GroupItems WHERE GroupId = '239_65GrkKS6kRL'

Zusätzlich kann OnBehalfOfContentOwner optional in der WHERE-Klausel verwendet werden.

Einfügen

GroupId und Resource_Id sind erforderlich, um ein Element in eine Gruppe einzufügen.

INSERT INTO GroupItems (GroupId, Resource_Id) VALUES ('fjgeeljgio54', 'dkhgjio5sfff')

Spalten

Gruppen

Erstellen, aktualisieren, löschen und Abfrage YouTube Analytics Gruppen.

Tabellenspezifische Informationen

Eine Gruppe ist eine benutzerdefinierte Sammlung von bis zu 200 Kanälen, Videos, Wiedergabelisten oder Assets. Alle Elemente in einer Gruppe müssen denselben Entitätstyp darstellen. Sie können beispielsweise keine Gruppe erstellen, die 100 Videos und 100 Wiedergabelisten enthält. Eine Analytics-Gruppe kann nur Entitäten enthalten, die Sie hochgeladen oder beansprucht haben oder die mit einem von Ihnen verwalteten Kanal verknüpft sind. Daher können Inhaltseigentümer Gruppen von Videos, Wiedergabelisten, Kanälen oder Assets erstellen. Kanaleigentümer können Gruppen von Videos und Wiedergabelisten erstellen.

Auswählen

Die folgenden Spalten können in der WHERE-Klausel verwendet werden: OnBehalfOfContentOwner und Mine.

Einfügen

Zum Einfügen einer Gruppe ist ContentDetails_ItemType erforderlich.

INSERT INTO Groups (Snippet_Title, ContentDetails_ItemType) VALUES ('test2', 'youtube#channel')

Spalten

Ansichten

Ansichten ähneln Tabellen hinsichtlich der Darstellung von Daten, sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre es eine normale Tabelle.

YouTube Analytics Connector-Ansichten

Aktivitäten

YouTube-Aktivitäten abfragen. Eine Aktivitätsressource enthält Informationen zu einer Aktion, die ein bestimmter Kanal oder Benutzer auf YouTube ausgeführt hat.

Tabellenspezifische Informationen

Auswählen

YouTube Analytics erlaubt nur die Verwendung der Kanal-ID als Filterkriterium. Darüber hinaus werden die zusätzlichen optionalen Spalten „PublishedAt“ und „Region“ unterstützt.

Alle Spalten unterstützen den Operator '='. PublishedAt unterstützt auch '>', '>=', '<' und '<='.

Wenn keine Filter angegeben sind, gibt der Treiber standardmäßig die vom authentifizierten Benutzer generierten Aktivitäten zurück.

SELECT * FROM Activities WHERE ChannelId = "abc123" AND PublishedAt < '2016-01-01T10:00:00Z'

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung der Aktivität verwendet.
PublishedAt	Datetime				Datum und Uhrzeit des Auftretens der Aktivität. Der Wert hat das Format ISO 8601 (JJJJ-MM-TTThhss.sZ).
ChannelId	String				Die ID, die YouTube verwendet, um den mit der Aktivität verknüpften Kanal eindeutig zu identifizieren.
Title	String				Der Titel der Ressource, die hauptsächlich mit der Aktivität verknüpft ist.
Description	String				Die Beschreibung der Ressource, die hauptsächlich mit der Aktivität verknüpft ist.
ChannelTitle	String				Kanaltitel für den Kanal, der für diese Aktivität verantwortlich ist.
Type	String				Der Aktivitätstyp, den die Ressource beschreibt. Gültige Werte: channelItem, Kommentar (derzeit nicht zurückgegeben), Favorit, Like, playlistItem, Empfehlung, Soziales, Abonnement und Upload.
GroupId	String				Die mit der Aktivität verknüpfte Gruppen-ID.
ThumbnailsDefaultUrl	String				Die URL der Standard-Miniaturansicht.
UploadVideoId	String				Die ID, die YouTube zur eindeutigen Identifizierung des hochgeladenen Videos verwendet.
LikeResourceIdKind	String				Der Typ der Ressource, die eine positive Bewertung (Gefällt mir) erhalten hat.
LikeResourceIdVideoId	String				Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet, wenn es sich bei der bewerteten Ressource um ein Video handelt. Diese Spalte ist nur vorhanden, wenn ResourceIdKind youtube#video ist.
FavoriteResourceIdKind	String				Der Typ der als Favorit markierten YouTube-Entität.
FavoriteResourceIdVideoId	String				Die ID, die YouTube zur eindeutigen Identifizierung des Lieblingsvideos verwendet.
CommentResourceIdKind	String				Der Kommentar zur API Ressource.
CommentResourceIdVideoId	String				Die ID, die YouTube verwendet, um das mit einem Kommentar verknüpfte Video eindeutig zu identifizieren.
CommentResourceIdChannelId	String				Die ID, die YouTube verwendet, um den mit einem Kommentar verknüpften Kanal eindeutig zu identifizieren.
SubscriptionResourceIdKind	String				Der Typ des Abonnements. Ein Abonnement ist ein Kanal, den ein Benutzer abonniert hat.
SubscriptionResourceIdChannelId	String				Die ID, die YouTube verwendet, um den Kanal, den der Benutzer abonniert hat, eindeutig zu identifizieren.
PlaylistItemResourceIdKind	String				Der Typ des Wiedergabelistenelements.
PlaylistItemResourceIdVideoId	String				Die ID, die YouTube verwendet, um das zur Playlist hinzugefügte Video eindeutig zu identifizieren.
PlaylistItemPlaylistId	String				Der Wert, den YouTube zur eindeutigen Identifizierung der Wiedergabeliste verwendet.
PlaylistItemPlaylistItemId	String				Der Wert, den YouTube verwendet, um das Element in der Wiedergabeliste eindeutig zu identifizieren.
RecommendationResourceIdKind	String				Der Typ der Empfehlung.
RecommendationResourceIdVideoId	String				Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet, wenn es sich bei der empfohlenen Ressource um ein Video handelt.
RecommendationResourceIdChannelId	String				Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, wenn es sich bei der empfohlenen Ressource um einen Kanal handelt.
RecommendationReason	String				Der Grund, warum die YouTube-Entität dem Benutzer empfohlen wurde. Gültige Werte für diese Spalte: nicht angegeben, Video als Favorit markiert, Video mit „Gefällt mir“ markiert und Video angesehen.
RecommendationSeedResourceIdKind	String				Der Typ der YouTube-Entität, die die Empfehlung verursacht hat.
RecommendationSeedResourceIdVideoId	String				Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet, wenn die Empfehlung durch ein bestimmtes Video verursacht wurde.
RecommendationSeedResourceIdChannelId	String				Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, wenn die Empfehlung von einem bestimmten Kanal verursacht wurde.
RecommendationSeedResourceIdPlaylistId	String				Die ID, die YouTube zur eindeutigen Identifizierung der Playlist verwendet, wenn die Empfehlung durch eine bestimmte Playlist verursacht wurde.
SocialType	String				Der Name des Social-Network-Beitrags. Gültige Werte für diese Spalte: Facebook, GooglePlus, Twitter und nicht angegeben.
SocialResourceIdKind	String				Der Typ des Social-Network-Beitrags.
SocialResourceIdVideoId	String				Die ID, die YouTube verwendet, um das in einem Beitrag in einem sozialen Netzwerk enthaltene Video eindeutig zu identifizieren, wenn der Beitrag auf ein Video verweist.
SocialResourceIdChannelId	String				Die ID, die YouTube verwendet, um den in einem Beitrag in einem sozialen Netzwerk vorgestellten Kanal eindeutig zu identifizieren, wenn der Beitrag auf einen Kanal verweist.
SocialResourceIdPlaylistId	String				Die ID, die YouTube zur eindeutigen Identifizierung der in einem Social-Network-Beitrag enthaltenen Playlist verwendet.
SocialAuthor	String				Der Autor des Social-Network-Beitrags.
SocialReferenceUrl	String				Die URL des Social-Network-Beitrags.
SocialImageUrl	String				Ein Bild des Autors des Beitrags.
ChannelItemResourceId	String				Die ID der YouTube-Entität, die dem Kanal hinzugefügt wurde.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AdPerformanceReports

Anzeigenleistungsberichte abfragen. Anzeigenleistungsberichte bieten impressionenbasierte Metriken für Anzeigen, die während der Videowiedergabe geschaltet wurden. Diese Metriken berücksichtigen jeden Anzeigeneindruck, und jede Videowiedergabe kann mehrere Eindrücke ergeben.

Tabellenspezifische Informationen

Auswählen

Bruttoeinnahmen für ein Video in einem bestimmten Land abrufen, gruppiert nach Anzeigentyp und Tag:

SELECT Country, AdType, Day, GrossRevenue, StartDate, EndDate FROM AdPerformanceReports WHERE video = 'vid123' AND continent = '019'

Regeln auswählen

Anzeigenleistungsberichte für Inhaltseigentümer:

| Dimensionen | Erforderlich | Anzeigentyp | | -------------- | -------------------------------- | | Optional| Tag | | Metriken | Verwenden Sie 1 oder mehr | Bruttoumsatz, Anzeigenimpressionen, CPM | | Filter | Verwenden Sie genau ein | Video, eine Gruppe oder eine unterstützte Kombination aus UploaderType und ClaimedStatus | | Use 0 or one| Land, Kontinent, Subkontinent |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bildunterschriften

Abfrage von YouTube-Untertiteln. Eine Untertitelressource stellt eine YouTube-Untertitelspur dar.

Tabellenspezifische Informationen

Auswählen

YouTube Analytics lässt nur die Verwendung einer Teilmenge von Spalten als Filterkriterien zu. Die Spalte „VideoId“ muss angegeben werden. Weitere unterstützte optionale Spalten sind „ID“ und „OnBehalfOfContentOwner“.

Alle Spalten unterstützen den Operator '='.

SELECT * FROM Captions WHERE VideoId = '123456789'

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung der Untertitelspur verwendet.
VideoId	String				Die ID, die YouTube verwendet, um das mit der Untertitelspur verknüpfte Video eindeutig zu identifizieren.
LastUpdated	Datetime				Datum und Uhrzeit der letzten Aktualisierung der Untertitelspur. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
TrackKind	String				Der Typ der Untertitelspur. Gültige Werte für diese Spalte: ASR (eine Untertitelspur, die mithilfe automatischer Spracherkennung generiert wird); Erzwungen (eine Untertitelspur, die abgespielt wird, wenn im Player keine andere Spur ausgewählt ist. Beispielsweise könnte ein Video, in dem Außerirdische in einer außerirdischen Sprache sprechen, eine erzwungene Untertitelspur haben, um nur Untertitel für die außerirdische Sprache anzuzeigen); Standard (eine normale Untertitelspur. Dies ist der Standardwert).
Language	String				Die Sprache der Untertitelspur. Der Spaltenwert ist ein BCP-47-Sprachtag.
Name	String				Der Name der Untertitelspur. Der Name soll dem Benutzer während der Wiedergabe als Option angezeigt werden.
AudioTrackType	String				Der Typ der Audiospur, die mit der Untertitelspur verknüpft ist. Gültige Werte für diese Spalte: Kommentar (die Untertitelspur entspricht einer alternativen Audiospur, die einen Kommentar enthält, z. B. einen Kommentar des Regisseurs); beschreibend (die Untertitelspur entspricht einer alternativen Audiospur, die zusätzlichen beschreibenden Ton enthält); primär (die Untertitelspur entspricht der primären Audiospur für das Video, also der Audiospur, die normalerweise mit dem Video verknüpft ist); unbekannt (dies ist der Standardwert).
IsCC	Boolean				Gibt an, ob der Titel Untertitel für Gehörlose und Schwerhörige enthält. Der Standardwert ist „false“.
IsLarge	Boolean				Gibt an, ob die Untertitelspur großen Text für Sehbehinderte verwendet. Der Standardwert ist „false“.
IsEasyReader	Boolean				Gibt an, ob die Untertitelspur für einfaches Lesen formatiert ist, also auf dem Niveau der dritten Klasse für Sprachlernende. Der Standardwert ist „false“.
IsDraft	Boolean				Gibt an, ob es sich bei der Untertitelspur um einen Entwurf handelt. Wenn der Wert „true“ ist, ist die Spur nicht öffentlich sichtbar. Der Standardwert ist „false“.
IsAutoSynced	Boolean				Gibt an, ob YouTube die Untertitelspur mit der Audiospur im Video synchronisiert hat. Der Wert ist „true“, wenn beim Hochladen der Untertitelspur ausdrücklich eine Synchronisierung angefordert wurde. Wenn der Wert „false“ ist, verwendet YouTube die Zeitcodes in der hochgeladenen Untertitelspur, um zu bestimmen, wann Untertitel angezeigt werden.
Status	String				Der Status der Untertitelspur. Gültige Werte für diese Spalte: Fehlgeschlagen, Bereitstellen, Synchronisieren.
FailureReason	String				Der Grund, warum YouTube die Untertitelspur nicht verarbeiten konnte. Gültige Werte: processingFailed (YouTube konnte die hochgeladene Untertitelspur nicht verarbeiten); unknownFormat (das Format der Untertitelspur wurde nicht erkannt); unsupportedFormat (das Format der Untertitelspur wird nicht unterstützt).

Kanäle

YouTube-Kanäle abfragen.

Tabellenspezifische Informationen

Auswählen

Standardmäßig SupportEnhancedSQL ist auf true gesetzt und das Folgende wird an YouTube Analytics übergeben, falls vorhanden. Andere Filter werden clientseitig ausgeführt. Wenn SupportEnhancedSQL auf „False“ gesetzt ist, werden nur die folgenden Filter berücksichtigt.

Wenn keine Filter angegeben sind, gibt der Treiber standardmäßig alle Kanäle zurück, die dem authentifizierten Benutzer gehören.

YouTube Analytics lässt nur die Verwendung einer Teilmenge von Spalten als Filterkriterium zu. Die Kanäle können nach der ID gefiltert werden. Als zusätzliche optionale Spalten werden Language und ChannelId unterstützt.

Eine Suche in allen Kanälen in YouTube Analytics kann durch die Angabe eines oder mehrerer Suchbegriffe, Kanal-ID, Region, SafeSearch, Bewertung oder Relevanz ausgelöst werden, um alle Kanäle zu durchsuchen.

Alle Spalten unterstützen den Operator „=“. „PublishedAt“ unterstützt auch „>“, „>=“, „<“ und „<=“.

Die Option „Sortieren nach“ wird für die Spalten „Bewertung“, „Relevanz“ und „Titel“ unterstützt.

SELECT * FROM Channels WHERE Id = 'abc123'
SELECT * FROM Channels WHERE ChannelId = 'abc123' AND SearchTerms = 'music|movies-horror' ORDER BY Rating LIMIT 10

Hinweis: Die Sortierung wird nicht unterstützt, wenn eine der Spalten angegeben wird, die für die Suche nach Kanälen wie Suchbegriffe verwendet werden.

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet.
Title	String				Der Titel des Kanals.
Description	String				Die Beschreibung des Kanals. Der Wert der Spalte hat eine maximale Länge von 1000 Zeichen.
CustomUrl	String				Die benutzerdefinierte URL des Kanals.
PublishedAt	Datetime				Datum und Uhrzeit der Kanalerstellung. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
ThumbnailsDefaultUrl	String				Die URL der Standard-Miniaturansicht.
DefaultLanguage	String				Diese Spalte ist für vertrauenswürdige Tester vertraulich.
LiveBroadcastContent	String				Ein Hinweis darauf, ob eine Video- oder Kanalressource über Liveübertragungsinhalte verfügt.
LocalizedTitle	String				Diese Spalte ist vertraulich und nur für vertrauenswürdige Tester bestimmt. Der lokalisierte Videotitel.
LocalizedDescription	String				Diese Spalte ist vertraulich und nur für vertrauenswürdige Tester bestimmt. Die lokalisierte Videobeschreibung.
Country	String				Das Land, mit dem der Kanal verbunden ist.
ViewCount	Long				Die Häufigkeit, mit der der Kanal aufgerufen wurde.
SubscriberCount	Long				Die Anzahl der Abonnenten des Kanals. Dieser Wert wird auf drei signifikante Stellen abgerundet.
HiddenSubscriberCount	Boolean				Gibt an, ob die Abonnentenzahl des Kanals öffentlich sichtbar ist.
VideoCount	Long				Die Anzahl der auf den Kanal hochgeladenen Videos.
RelatedPlaylistsLikes	String				Die ID der Playlist, die die beliebten Videos des Kanals enthält.
RelatedPlaylistsUploads	String				Die ID der Playlist, die die hochgeladenen Videos des Kanals enthält.
PrivacyStatus	String				Datenschutzstatus des Kanals. Gültige Werte für diese Spalte: privat, öffentlich, nicht gelistet.
IsLinked	Boolean				Gibt an, ob die Kanaldaten einen Benutzer identifizieren, der bereits mit einem YouTube-Nutzernamen oder einem Google+-Konto verknüpft ist. Ein Benutzer mit einem dieser Links hat bereits eine öffentliche YouTube-Identität, die Voraussetzung für mehrere Aktionen ist, z. B. das Hochladen von Videos.
LongUploadsStatus	String				Gibt an, ob der Kanal Videos hochladen darf, die länger als 15 Minuten sind. Diese Spalte wird nur zurückgegeben, wenn der Kanalbesitzer die API -Anforderung autorisiert hat. Weitere Informationen zu dieser Funktion finden Sie im YouTube-Hilfecenter.
MadeForKids	Boolean				Dieser Wert gibt an, ob der Kanal als für Kinder gedacht gekennzeichnet ist und enthält den aktuellen „Speziell für Kinder“-Status des Kanals.
Keywords	String				Mit Ihrem Kanal verknüpfte Schlüsselwörter. Der Wert ist eine durch Leerzeichen getrennte Liste von Zeichenfolgen.
TrackingAnalyticsAccountId	String				Die ID für ein Google Analytics-Konto, das Sie zum Verfolgen und Messen des Datenverkehrs zu Ihrem Kanal verwenden möchten.
ModerateComments	Boolean				Diese Einstellung legt fest, ob von Benutzern übermittelte Kommentare auf der Kanalseite vom Kanalbesitzer genehmigt werden müssen, um öffentlich sichtbar zu sein. Der Standardwert ist „false“.
SearchTerms	String				Der Parameter SearchTerms gibt den Abfrage an, nach dem gesucht werden soll.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kanalabschnitte

Abfrage von YouTube-Kanalabschnitten. Ein Kanalabschnitt enthält Informationen zu einer Reihe von Videos, die ein Kanal zur Anzeige ausgewählt hat.

Tabellenspezifische Informationen

Auswählen

YouTube Analytics lässt nur die Verwendung einer Teilmenge von Spalten als Filterkriterium zu. Sie können genau eine der folgenden Spalten angeben: ChannelId oder Id. Zusätzlich werden optional die Spalten Language und OnBehalfOfContentOwner unterstützt.

Alle Spalten unterstützen den Operator '='.

Wenn keine Kanal-ID angegeben ist, gibt der Treiber standardmäßig Kanalabschnitte für den Kanal zurück, der dem authentifizierten Benutzer gehört.

SELECT * FROM ChannelSections WHERE ChannelId = '123456789'

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kommentare

YouTube-Kommentare abfragen.

Tabellenspezifische Informationen

Auswählen

YouTube Analytics lässt nur die Verwendung einer Teilmenge von Spalten als Filterkriterium zu. Sie müssen genau eine der folgenden Spalten angeben: ID oder ParentId. Zusätzliche unterstützte optionale Spalten sind TextFormat.

Alle Spalten unterstützen den Operator '='.

SELECT * FROM Comments WHERE ID = '123456789'

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung des Kommentars verwendet.
ChannelId	String				Die ID des mit dem Kommentar verknüpften YouTube-Kanals. Wenn es sich bei dem Kommentar um einen Videokommentar handelt, identifiziert diese Spalte den Kanal des Videos und die Spalte „VideoId“ das Video. Wenn es sich bei dem Kommentar um einen Kanalkommentar handelt, identifiziert diese Spalte den Kanal, auf den sich der Kommentar bezieht.
VideoId	String				Die ID des Videos, auf das sich der Kommentar bezieht.
TextDisplay	String				Der Text des Kommentars. Der Text kann entweder im Klartext oder im HTML-Format abgerufen werden. Die Pseudospalte TextFormat gibt das gewünschte Textformat an.
TextOriginal	String				Der ursprüngliche, unverarbeitete Text des Kommentars, wie er ursprünglich gepostet oder zuletzt aktualisiert wurde. Der Originaltext wird nur zurückgegeben, wenn er für den authentifizierten Benutzer zugänglich ist, was nur gewährleistet ist, wenn der Benutzer der Autor des Kommentars ist.
ParentId	String				Die eindeutige ID des übergeordneten Kommentars. Dieser Spaltenwert wird nur festgelegt, wenn der Kommentar als Antwort auf einen anderen Kommentar übermittelt wurde.
AuthorDisplayName	String				Der Anzeigename des Benutzers, der den Kommentar gepostet hat.
AuthorProfileImageUrl	String				Die URL für den Avatar des Benutzers, der den Kommentar gepostet hat.
AuthorChannelUrl	String				Die URL des YouTube-Kanals des Kommentarautors, sofern verfügbar.
AuthorChannelIdValue	String				Die ID des YouTube-Kanals des Kommentarautors, sofern verfügbar.
AuthorGoogleplusProfileUrl	String				Die URL des Google+-Profils des Kommentarautors, sofern verfügbar.
CanRate	Boolean				Diese Einstellung gibt an, ob der aktuelle Betrachter den Kommentar bewerten kann.
ViewerRating	String				Die Bewertung, die der Betrachter diesem Kommentar gegeben hat. Gültige Werte für diese Spalte: „Gefällt mir“, „Keine“. Beachten Sie, dass diese Spalte derzeit keine Bewertungen „Gefällt mir nicht“ angibt. Der Spaltenwert ist „Gefällt mir“, wenn der Betrachter den Kommentar positiv bewertet hat. In allen anderen Fällen ist der Wert „Keine“, auch wenn der Benutzer dem Kommentar eine negative Bewertung gegeben oder den Kommentar nicht bewertet hat.
LikeCount	Integer				Die Gesamtzahl der Likes (positiven Bewertungen), die der Kommentar erhalten hat.
ModerationStatus	String				Der Moderationsstatus des Kommentars. Dieser Wert wird nur zurückgegeben, wenn die API Anforderung vom Eigentümer des Kanals oder des Videos autorisiert wurde, zu dem die angeforderten Kommentare abgegeben wurden. Beachten Sie außerdem, dass dieser Wert nicht festgelegt wird, wenn die Abfrage nach der ID-Spalte gefiltert wurde. Gültige Werte: heldForReview, probabilitySpam, veröffentlicht, abgelehnt.
PublishedAt	Datetime				Datum und Uhrzeit der ursprünglichen Veröffentlichung des Kommentars. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
UpdatedAt	Datetime				Datum und Uhrzeit der letzten Aktualisierung des Kommentars. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kommentarthreads

Abfrage von YouTube-Kommentarthreads. Ein CommentThread-Datensatz enthält Informationen zu einem YouTube-Kommentarthread, einem Kommentar der obersten Ebene und Antworten auf diesen Kommentar, sofern vorhanden.

Tabellenspezifische Informationen

Auswählen

YouTube Analytics lässt nur die Verwendung einer Teilmenge von Spalten als Filterkriterium zu. Sie müssen genau eine der folgenden Spalten angeben: AllThreadsRelatedToChannelId, ChannelId, Id oder VideoId.

Zusätzliche optionale Spalten, die unterstützt werden, sind ModerationStatus, SearchTerms und TextFormat. Alle Spalten unterstützen den Operator '='.

Für CommentThreads wird die Reihenfolge unterstützt. Relevanz sind die unterstützten Reihenfolgespalten.

SELECT * FROM CommentThreads WHERE VideoId = 'abcdef123456' ORDER BY Relevance DESC LIMIT 10

Hinweis: Die Sortierung wird in Verbindung mit dem ID-Parameter nicht unterstützt.

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Demografie

Abfrage der YouTubeAnalytics-Demografie nach Altersgruppen und Geschlecht.

Tabellenspezifische Informationen

Auswählen

Aggregierte Anzeigestatistiken für Videos basierend auf Altersgruppe und Geschlecht der Zuschauer:

SELECT * FROM Demographics

Demografische Daten für nur ein Video reduzieren:

SELECT * FROM Demographics WHERE Video = 'video_Id'

Aggregierte Anzeigestatistiken für Wiedergabelisten basierend auf Altersgruppe und Geschlecht der Zuschauer:

SELECT * FROM Demographics WHERE IsCurated = true

Regeln auswählen

Sie können die folgenden Tabellen verwenden, um andere Abfragen für Top-Videos zu erstellen.

Demografische Daten für Videos:

| Dimensionen | Verwenden Sie 1 oder mehr | Altersgruppe, Geschlecht, Video | | --------------- | -------------------------------------------------- ------------------- | | Use 0 or more| Erstellerinhalttyp, live oder auf Abruf, Abonniertstatus, YouTube-Produkt | | Metriken | Verwenden Sie 1 oder mehr | viewerPercentage | | Filter | Verwenden Sie 0 oder 1 | Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Video, Gruppe | | Use 0 or more| liveOrOnDemand, AbonniertStatus, YouTube-Produkt |

Demografie für Wiedergabelisten:

| Dimensionen | Verwenden Sie 1 oder mehr | Altersgruppe, Geschlecht | | --------------- | ------------------------------------------ | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Metriken | Erforderlich | viewerPercentage | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Video, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Demografische Daten für Inhaltseigentümer:

| Dimensionen | Verwenden Sie 1 oder mehr | Altersgruppe, Geschlecht | | --------------- | -------------------------------------------------- ------------------- | | Use 0 or more| Erstellerinhalttyp, live oder auf Abruf, Abonniertstatus, YouTube-Produkt | | Metriken | Verwenden Sie 1 oder mehr | viewerPercentage | | Filter | Genau ein | Video, einen Kanal, eine Gruppe verwenden | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or more| liveOrOnDemand, AbonniertStatus, YouTube-Produkt |

Demografische Daten für Playlists von Inhaltseigentümern:

| Dimensionen | Verwenden Sie 1 oder mehr | Altersgruppe, Geschlecht | | --------------- | ------------------------------------------ | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Metriken | Erforderlich | viewerPercentage | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Geräte

Abfrage von YouTubeAnalytics-Statistiken zu Geräten oder Operationssystemen. Diese Tabelle ermöglicht Ihnen die Zusammenstellung von Anzeigestatistiken basierend auf der Art und Weise, wie Zuschauer Ihre Videoinhalte erreicht haben. Sie können beispielsweise die Anzahl der Aufrufe ermitteln, die auf Mobilgeräten oder Spielekonsolen erfolgten.

Tabellenspezifische Informationen

Auswählen

Standardmäßig erfolgt die Gruppierung nach Gerätetyp:

SELECT * FROM Devices

Sie können Ansichten jedoch nach anderen Dimensionen wie dem Operationssystem gruppieren:

SELECT OperatingSystem, Views, EstimatedMinutesWatched FROM Devices

Beachten Sie, dass Sie aufgrund von Einschränkungen der YouTube Analytics API Gerätetyp und Operationssystem nicht in derselben Abfrage kombinieren können.

Regeln auswählen

Sie können die folgenden Tabellen verwenden, um andere Abfragen an Geräte zu erstellen:

Geräte für Videos:

| Dimensionen | Verwenden Sie genau eine | Gerätetyp, Operationssystem | | --------------- | -------------------------------------------------- --------- | | Use 0 or more| CreatorContentType, Tag, live oder auf Abruf, Abonniertstatus, YouTube-Produkt | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten | | Filter | Verwenden Sie 0 oder 1 | Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Video, Gruppe | | Use 0 or more| Operationssystem, live oder auf Abruf, Abonniertstatus, YouTube-Produkt |

Gerätedaten für Wiedergabelisten:

| Dimensionen | Verwenden Sie genau eine | Gerätetyp, Operationssystem | | --------------- | ------------------------------------------------- | | Use 0 or more| Tag, AbonniertStatus, YouTubeProdukt | | Metriken | Verwende 1 oder mehr | Ansichten, geschätzte angesehene Minuten, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Use 0 or more| Operationssystem, Abonnementstatus, YouTube-Produkt |

Gerätedaten für Inhaltseigentümer:

| Abmessungen | Erforderlich | Gerätetyp | | --------------- | -------------------------------------------------- --------- | | Use 0 or more| CreatorContentType, Tag, live oder auf Abruf, Abonniertstatus, YouTube-Produkt | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten | | Filter | Genau ein | Video, einen Kanal, eine Gruppe verwenden | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or more| Operationssystem, live oder auf Abruf, Abonniertstatus, YouTube-Produkt |

Gerätedaten für Wiedergabelisten des Inhaltseigentümers:

| Abmessungen | Erforderlich | Gerätetyp | | --------------- | ------------------------------------------------- | | Use 0 or more| Tag, AbonniertStatus, YouTubeProdukt | | Metriken | Verwende 1 oder mehr | Ansichten, geschätzte angesehene Minuten, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Use 0 or more| Operationssystem, Abonnementstatus, YouTube-Produkt |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

EngagementBerichte

Informationen zu Engagement-Berichten abfragen. Beispielsweise, wie oft ein Benutzer ein Video geteilt hat.

Tabellenspezifische Informationen

Auswählen

Standardmäßig werden die Ergebnisse nach Tag gruppiert. Die folgende Abfrage gibt Kommentare, Likes, Dislikes usw. gruppiert nach Tag zurück:

SELECT * FROM EngagementReports

Regeln auswählen

Die folgende Abfrage gibt zurück, wie häufig die Videos des Kanals auf verschiedenen sozialen Plattformen geteilt wurden:

SELECT SharingService, Shares FROM EngagementReports

Sie können die folgenden Tabellen verwenden, um weitere Abfragen für Engagement-Berichte zu erstellen:

Engagement-Berichte für Videos:

| Dimensionen | Erforderlich | sharingService | | -------------- | ------------------------------------ | | Optional| Inhaltstyp des Erstellers, Abonniertstatus | | Metriken | Verwenden Sie 1 oder mehr | Anteile | | Filter | Verwenden Sie 0 oder 1 | Land, Kontinent, Subkontinent | | Use 0 or one| Video, Gruppe | | Optional| AbonniertStatus |

Engagement-Berichte für Inhaltseigentümer:

| Dimensionen | Erforderlich | sharingService | | -------------- | ------------------------------------ | | Optional| Inhaltstyp des Erstellers, Abonniertstatus | | Metriken | Verwenden Sie 1 oder mehr | Anteile | | Filter | Genau ein | Video, einen Kanal, eine Gruppe verwenden | | Use 0 or one| Land, Kontinent, Subkontinent | | Optional| AbonniertStatus |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Sprachen

YouTube i18nLanguages abfragen. Eine i18nLanguage-Ressource identifiziert eine Anwendungssprache, die von der YouTube-Website unterstützt wird. Die Anwendungssprache kann auch als UI-Sprache bezeichnet werden.

Tabellenspezifische Informationen

Auswählen

Für diese Tabelle sind keine Filter erforderlich. Eine optionale unterstützte Spalte ist Sprache.

Alle Spalten unterstützen den Operator '='.

Spalten

PlayListItems

YouTube PlayListItems abfragen. Eine PlayListItem-Ressource identifiziert eine andere YouTube-Entität, z. B. ein Video, das in einer PlayList enthalten ist. Darüber hinaus enthält der PlayListItem-Datensatz Details darüber, wie diese Entität in dieser PlayList verwendet wird.

Tabellenspezifische Informationen

Auswählen

Sie müssen in der WHERE-Klausel genau eine der folgenden Spalten angeben: ID oder PlayListId. Zusätzliche optionale Spalten, die unterstützt werden, sind OnBehalfOfContentOwner und VideoId.

Alle Spalten unterstützen den Operator '='.

SELECT * FROM PlaylistItems WHERE PlaylistId = 'abcdef123456'

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung des Playlist-Elements verwendet.
PublishedAt	Datetime				Datum und Uhrzeit, zu denen das Element zur Wiedergabeliste hinzugefügt wurde. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
ChannelId	String				Die ID, die YouTube verwendet, um den Benutzer eindeutig zu identifizieren, der das Element zur Wiedergabeliste hinzugefügt hat.
Title	String				Der Titel des Artikels.
Description	String				Die Beschreibung des Artikels.
ThumbnailsDefaultUrl	String				Die URL des Artikels.
ChannelTitle	String				Der Kanaltitel des Kanals, zu dem das Playlist-Element gehört.
VideoOwnerChannelTitle	String				Der Kanaltitel des Kanals, der dieses Video hochgeladen hat.
VideoOwnerChannelId	String				Die Kanal-ID des Kanals, der dieses Video hochgeladen hat.
PlaylistId	String				Die ID, die YouTube verwendet, um die Playlist, in der sich das Playlist-Element befindet, eindeutig zu identifizieren.
Position	String				Die Reihenfolge, in der das Element in der Wiedergabeliste angezeigt wird. Der Wert verwendet einen nullbasierten Index, sodass das erste Element die Position 0 hat, das zweite Element die Position 1 und so weiter.
ResourceIdKind	String				Die Art oder der Typ der referenzierten Ressource.
ResourceIdVideoId	String				Wenn der ResourceIdKind-Wert der Spalte youtube#video lautet, ist diese Spalte vorhanden und ihr Wert enthält die ID, die YouTube verwendet, um das Video in der Wiedergabeliste eindeutig zu identifizieren.
VideoId	String				Die ID, die YouTube zur eindeutigen Identifizierung eines Videos verwendet. Um die Videoressource abzurufen, legen Sie die ID-Spalte auf diesen Wert fest.
Note	String				Eine vom Benutzer erstellte Notiz für diesen Artikel.
VideoOwnerPublishedAt	Datetime				Datum und Uhrzeit der Veröffentlichung des Videos auf YouTube. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
PrivacyStatus	String				Der Datenschutzstatus des Wiedergabelistenelements.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Playlists

YouTube-Playlists abfragen. Eine Playlist ist eine Sammlung von Videos, die nacheinander angesehen und mit anderen Benutzern geteilt werden können.

Tabellenspezifische Informationen

Auswählen

Standardmäßig SupportEnhancedSQL ist auf true gesetzt und das Folgende wird an YouTube Analytics übergeben, falls vorhanden. Andere Filter werden clientseitig ausgeführt. Wenn SupportEnhancedSQL auf „False“ gesetzt ist, werden nur die folgenden Filter berücksichtigt.

Wenn keine Filter angegeben sind, gibt der YouTube Analytics Connector standardmäßig alle Playlists für den Kanal zurück, der dem authentifizierten Benutzer gehört.

YouTube Analytics lässt nur die Verwendung einer Teilmenge von Spalten als Filterkriterium zu. Sie können genau eine der folgenden Spalten angeben: ChannelId oder Id. Weitere unterstützte optionale Spalten sind PublishedAt, Language, OnBehalfOfContentOwner und OnBehalfOfContentOwnerChannel.

Eine Suche in allen Kanälen in YouTube Analytics kann durch die Angabe eines oder mehrerer der Suchbegriffe, ForContentOwner, Region, SafeSearch, Bewertung und Rating ausgelöst werden, um alle Wiedergabelisten zu durchsuchen.

Alle Spalten unterstützen den Operator '='. PublishedAt unterstützt außerdem diese zusätzlichen Operatoren: '>', '>=', '<' und '<='.

Die Option „Sortieren nach“ wird für die Spalten „Bewertung“, „Relevanz“ und „Titel“ unterstützt.

SELECT * FROM PlayLists WHERE Id = 'abcdef123456'
SELECT title FROM PlayLists WHERE PublishedAt >= '2016-01-01' ORDER BY Title LIMIT 10

Hinweis: Die Sortierung wird nicht unterstützt, wenn eine der Spalten angegeben wird, die zum Suchen von Wiedergabelisten verwendet werden, z. B. Suchbegriffe.

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung der Playlist verwendet.
PublishedAt	Datetime				Datum und Uhrzeit der Erstellung der Wiedergabeliste. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
ChannelId	String				Die ID, die YouTube verwendet, um den Kanal, der die Playlist veröffentlicht hat, eindeutig zu identifizieren.
Title	String				Der Titel der Wiedergabeliste.
Description	String				Die Beschreibung der Wiedergabeliste.
ThumbnailsDefaultUrl	String				Die URL des Bildes.
ChannelTitle	String				Kanaltitel des Kanals, zu dem das Video gehört.
DefaultLanguage	String				Diese Spalte ist für vertrauenswürdige Tester vertraulich. Die Sprache des Textes in den Spalten „Titel“ und „Beschreibung“.
LocalizedTitle	String				Diese Spalte ist vertraulich und nur für vertrauenswürdige Tester bestimmt. Der lokalisierte Titel der Wiedergabeliste.
LocalizedDescription	String				Diese Spalte ist vertraulich und nur für vertrauenswürdige Tester bestimmt. Die lokalisierte Playlist-Beschreibung.
PrivacyStatus	String				Der Datenschutzstatus der Wiedergabeliste. Gültige Werte für diese Spalte: privat, öffentlich, nicht gelistet.
VideoCount	Integer				Die Anzahl der Videos in der Wiedergabeliste.
EmbedHtml	String				Ein Iframe-Tag, der einen Player einbettet, der die Playlist abspielt.
SearchTerms	String				Der Parameter SearchTerms gibt den Abfrage an, nach dem gesucht werden soll.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Regionen

YouTube i18nRegions abfragen. Eine i18nRegion-Ressource identifiziert einen geografischen Bereich, den ein YouTube-Benutzer als bevorzugte Inhaltsregion auswählen kann. Die Inhaltsregion kann auch als Inhaltsgebietsschema bezeichnet werden.

Tabellenspezifische Informationen

Auswählen

Für diese Tabelle sind keine Filter erforderlich. Eine optionale unterstützte Spalte ist Sprache.

Alle Spalten unterstützen den Operator '='.

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Abonnements

Abfrage von YouTube-Benutzerabonnements. Ein Abonnement benachrichtigt einen Benutzer, wenn einem Kanal neue Videos hinzugefügt werden oder wenn ein anderer Benutzer eine von mehreren Aktionen auf YouTube ausführt, z. B. ein Video hochlädt, ein Video bewertet oder ein Video kommentiert.

Tabellenspezifische Informationen

Auswählen

Sie können genau eine der folgenden Spalten angeben: ChannelId, Id, MyRecentSubscribers oder MySubscribers.

Zusätzliche optionale Spalten sind ForChannelId, OnBehalfOfContentOwner und OnBehalfOfContentOwnerChannel. Alle Spalten unterstützen den Operator „=“.

Für Abonnements wird die Reihenfolge unterstützt. Die unterstützten Sortierspalten sind „Alphabetisch“, „Relevanz“ und „Ungelesen“.

Wenn keine Filter angegeben sind, gibt der Treiber standardmäßig eine Liste der vom authentifizierten Benutzer abonnierten Kanäle zurück.

SELECT Title FROM Subscriptions WHERE ChannelId = 'abc123' ORDER BY Unread DESC

Der Standardwert ist SUBSCRIPTION_ORDER_RELEVANCE.

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung des Abonnements verwendet.
PublishedAt	Datetime				Datum und Uhrzeit der Erstellung des Abonnements. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
ChannelTitle	String				Der Titel des Kanals, zu dem das Abonnement gehört.
Title	String				Der Titel des Abonnements.
Description	String				Die Einzelheiten des Abonnements.
ResourceIdKind	String				Der Typ der API Ressource.
ResourceIdChannelId	String				Der Wert, den YouTube verwendet, um den Kanal, den der Benutzer abonniert hat, eindeutig zu identifizieren.
ChannelId	String				Die ID, die YouTube verwendet, um den Kanal des Abonnenten eindeutig zu identifizieren.
ThumbnailsDefaultUrl	String				Die URL des Standardbildes.
TotalItemCount	Integer				Die ungefähre Anzahl der Elemente, auf die das Abonnement verweist.
NewItemCount	Integer				Die Anzahl der neuen Elemente im Abonnement seit dem letzten Lesen seines Inhalts.
ActivityType	String				Der Aktivitätstyp, für den dieses Abonnement gilt. Gültige Werte: alle, Uploads.
SubscriberTitle	String				Der Titel des Kanals des Abonnenten.
SubscriberDescription	String				Die Beschreibung des Kanals des Abonnenten.
SubscriberChannelId	String				Die ID, die YouTube zuweist, um den Kanal des Abonnenten eindeutig zu identifizieren.
SubscriberThumbnailsDefaultUrl	String				Die URL des Standardbildes.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Zeitbasierte Berichte

Fragen Sie zeitbasierte Informationen zu Ansichten, Abonnenten usw. ab. Beispielsweise, wie viele neue Abonnenten zu einem bestimmten Zeitpunkt gewonnen wurden.

Tabellenspezifische Informationen

Regeln auswählen

Sie können die folgenden Tabellen verwenden, um Abfragen für zeitbasierte Berichte zu erstellen: Zeitbasierte Berichte für Videos:

| Dimensionen | Verwenden Sie 0 oder mehr | Tag, Monat, Video | | -------------- | ----------------- | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, Kommentare, „Gefällt mir“, „Gefällt mir nicht“, „Zu Playlists hinzugefügte“ Videos, „Aus Playlists entfernte“ Videos, Shares, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, AnnotationClickThroughRate, AnnotationCloseRate, AnnotationImpressionen, AnnotationKlickbare Impressionen, AnnotationSchließbare Impressionen, AnnotationKlicks, AnnotationAbschlüsse, gewonnene Abonnenten, verlorene Abonnenten, Uniques, Einnahmen, Anzeigeneinnahmen, Bruttoeinnahmen, RedPartner-Einnahmen, monetarisierte Wiedergaben, wiedergabebasierter CPM, Impressionen, impressionenbasierter CPM | | Filter | Verwenden Sie 0 oder 1 | Land, Kontinent, Subkontinent | | Use 0 or one| Video, Gruppe |

Zeitbasierte Berichte für Playlist-Regeln:

| Dimensionen | Genau eine verwenden | Tag, Monat | | --------------- | ------------------------------------------ | | Optional| Inhaltstyp des Erstellers | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Zeitbasierte Berichte für Inhaltseigentümerregeln:

| Dimensionen | Genau eine verwenden | Tag, Monat | | -------------- | -------------------------------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, Kommentare, „Gefällt mir“, „Gefällt mir nicht“, „Zu Playlists hinzugefügte“ Videos, „Aus Playlists entfernte“ Videos, Shares, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, AnnotationClickThroughRate, AnnotationCloseRate, AnnotationImpressionen, AnnotationKlickbare Impressionen, AnnotationSchließbare Impressionen, AnnotationKlicks, AnnotationAbschlüsse, gewonnene Abonnenten, verlorene Abonnenten, Uniques, Einnahmen, Anzeigeneinnahmen, Bruttoeinnahmen, RedPartner-Einnahmen, monetarisierte Wiedergaben, wiedergabebasierter CPM, Impressionen, impressionenbasierter CPM | | Filter | Genau ein | Video, einen Kanal, eine Gruppe verwenden | | Use 0 or one| Land, Kontinent, Subkontinent |

Zeitbasierte Berichte für Playlist-Regeln des Inhaltseigentümers:

| Dimensionen | Genau eine verwenden | Tag, Monat | | --------------- | ------------------------------------------ | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Metriken | Verwende 1 oder mehr | Ansichten, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

TopVideos

Fragen Sie die TopVideos für einen Kanal oder die TopPlaylists ab, wenn Sie Inhaltseigentümer sind. Sie können diese Ansicht auch verwenden, um Wiedergabedetails und geografische Filter Abfrage.

Tabellenspezifische Informationen

Auswählen

Die folgende Abfrage gibt die Top-Videos eines Kanals zurück:

SELECT * FROM TopVideos

Die folgende Abfrage gibt die Top-Videos eines Kanals nach der höchsten Wiedergabedauer in Minuten in einem bestimmten Land zurück:

SELECT Video, Views, EstimatedMinutesWatched, AverageViewDuration, AverageViewPercentage FROM TopVideos WHERE Country = 'US'

Die folgende Abfrage gibt die Top-Wiedergabelisten eines Kanals nach der Anzahl der Wiedergabeminuten zurück:

SELECT Playlist, Views, EstimatedMinutesWatched, PlaylistStarts, AverageViewDuration FROM TopVideos WHERE IsCurated = true

Regeln auswählen

Sie können die folgenden Tabellen verwenden, um andere Abfragen für Top-Videos zu erstellen:

Top-Videos für Videos:

| Dimensionen | Erforderlich | Video | | -------------- | ------------------------------------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, Kommentare, „Gefällt mir“, „Gefällt mir nicht“, „Zu Playlists hinzugefügte Videos“, „Aus Playlists entfernte Videos“, „Shares“, „Geschätzte angesehene Minuten“, „Durchschnittliche Ansichtsdauer“, „Durchschnittlicher Ansichtsprozentsatz“, „AnnotationClickThroughRate“, „AnnotationCloseRate“, „AnnotationImpressions“, „AnnotationClickableImpressions“, „AnnotationClosableImpressions“, „AnnotationClicks“, „AnnotationCloses“, „Gewonnene Abonnenten“, „Verlorene Abonnenten“ | | Filter | Verwenden Sie 0 oder 1 | Land, Kontinent, Subkontinent | | Sortieren | Verwenden Sie 0 oder mehr (nur absteigende Reihenfolge) | Aufrufe, geschätzte angesehene Minuten, gewonnene Abonnenten, verlorene Abonnenten |

Top-Videos für Playlists:

| Abmessungen | Erforderlich | Playlist | | --------------- | ------------------------------------------ | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or more| Playlist, AbonniertStatus, YouTube-Produkt | | Sortieren | Verwenden Sie 0 oder mehr (nur absteigende Reihenfolge) | Aufrufe, geschätzte angesehene Minuten, Playliststarts |

Top-Videos für Inhaltseigentümer:

| Abmessungen | Erforderlich | Video | | -------------- | ------------------------------------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, Kommentare, „Gefällt mir“, „Gefällt mir nicht“, „Zu Playlists hinzugefügte“ Videos, „Aus Playlists entfernte“ Videos, Shares, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, Anmerkung „ClickThroughRate“, Anmerkung „CloseRate“, Anmerkung „Impressionen“, Anmerkung „Klickbare Impressionen“, Anmerkung „Schließbare Impressionen“, Anmerkung „Klicks“, Anmerkung „Abschlüsse“, gewonnene Abonnenten, verlorene Abonnenten, Einnahmen, Anzeigeneinnahmen, Bruttoeinnahmen, Einnahmen aus roten Partnern, monetarisierte Wiedergaben, wiedergabebasierter CPM, Impressionen, impressionenbasierter CPM | | Filter | Benutze genau einen | Kanal | | Use 0 or one| Land, Kontinent, Subkontinent | | Sortieren | Verwenden Sie 0 oder mehr (nur absteigende Reihenfolge) | Aufrufe, Einnahmen, RedPartnerRevenue, geschätzte angesehene Minuten, gewonnene Abonnenten, verlorene Abonnenten |

Top-Videos für Playlists von Inhaltseigentümern:

| Abmessungen | Erforderlich | Playlist | | --------------- | ------------------------------------------ | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten, durchschnittliche Ansichtsdauer, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Wiedergabeliste, Kanal | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Sortieren | Verwenden Sie 0 oder mehr (nur absteigende Reihenfolge) | Aufrufe, geschätzte angesehene Minuten, Playliststarts |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Datenverkehrsquellen

TrafficSources abfragen. Statistiken basieren auf der Art und Weise, wie Zuschauer Ihre Video- und Playlist-Inhalte erreicht haben.

Tabellenspezifische Informationen

Auswählen

Die folgende Abfrage aggregiert Anzeigestatistiken basierend auf der Art und Weise, wie Zuschauer auf Ihre Videoinhalte gelangt sind. Sie ermittelt beispielsweise die Anzahl der Aufrufe, die über eine Google-Suche oder einen Link zu einem verwandten Video zustande kamen.

SELECT * FROM TrafficSources

Die folgende Abfrage zeigt die Metriken „Views“ und „EstimatedMinutesWatched“ gruppiert nach den Dimensionen „Day“ und „InsightTrafficSourceType“ an:

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources

Die folgende Abfrage filtert die zu erstellenden Statistiken für ein bestimmtes Video und Land:

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources WHERE Video = 'video_id' AND Country = 'US'

Die folgende Abfrage aggregiert die Anzeigestatistiken auf Grundlage der Art und Weise, wie die Zuschauer auf die Inhalte Ihrer Wiedergabeliste gelangt sind. Sie dient beispielsweise zur Ermittlung der Anzahl der Aufrufe, die aus einer Google-Suche resultierten.

SELECT InsightTrafficSourceType, Views, EstimatedMinutesWatched, PlaylistStarts, ViewsPerPlaylistStart, AverageTimeInPlaylist FROM TrafficSources WHERE IsCurated = true

Die folgende Abfrage gibt Suchbegriffe zurück, die die meisten Aufrufe aus den YouTube-Suchergebnissen für Videos in Wiedergabelisten generiert haben. Beachten Sie, dass aufgrund von Einschränkungen in der YouTube Analytics API für eine solche Abfrage eine Sortierung und Begrenzung erforderlich ist.

SELECT InsightTrafficSourceDetail, Views, EstimatedMinutesWatched, PlaylistStarts, ViewsPerPlaylistStart, AverageTimeInPlaylist FROM TrafficSources WHERE IsCurated = true AND InsightTrafficSourceType = 'YT_SEARCH' ORDER BY Views DESC LIMIT 25

Regeln auswählen

Sie können die folgenden Tabellen verwenden, um andere Abfragen für Traffic-Quellen zu erstellen:

Traffic-Quellen für Videos:

| Dimensionen | Genau eine verwenden | insightTrafficSourceType, insightTrafficSourceDetail | | --------------- | -------------------------------------------------- ------- | | Use 0 or more| CreatorContentType, Tag, liveOrOnDemand, AbonniertStatus | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten | | Filter | Verwenden Sie 0 oder 1 | Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Video, Gruppe | | Use 0 or more| liveOrOnDemand, AbonniertStatus | | Sortieren | Verwenden Sie 0 oder mehr (nur absteigende Reihenfolge) | Aufrufe, geschätzte Anzahl der angesehenen Minuten |

Verkehrsquellen für Wiedergabelisten:

| Dimensionen | Verwenden Sie genau eine | insightTrafficSourceType, insightTrafficSourceDetail | | --------------- | ------------------------------------------ | | Use 0 or more| Tag, AbonniertStatus | | Metriken | Verwende 1 oder mehr | Ansichten, geschätzte angesehene Minuten, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Optional| AbonniertStatus | | Sortieren | Verwenden Sie 0 oder mehr (nur absteigende Reihenfolge) | Aufrufe, geschätzte angesehene Minuten, Playlist-Starts |

Verkehrsquellen für Inhaltseigentümer:

| Dimensionen | Erforderlich | insightTrafficSourceType | | --------------- | -------------------------------------------------- ------- | | Use 0 or more| CreatorContentType, Tag, liveOrOnDemand, AbonniertStatus | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, geschätzte angesehene Minuten | | Filter | Genau ein | Video, einen Kanal, eine Gruppe verwenden | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or more| liveOrOnDemand, AbonniertStatus |

Verkehrsquellen für Wiedergabelisten von Inhaltseigentümern:

| Dimensionen | Erforderlich | insightTrafficSourceType | | --------------- | ------------------------------------------ | | Use 0 or more| Tag, AbonniertStatus | | Metriken | Verwende 1 oder mehr | Ansichten, geschätzte angesehene Minuten, Playliststarts, Ansichten pro Playliststart, durchschnittliche Zeit in Playlist | | Filter | Erforderlich | isCurated=true | | Use 0 or one| Land, Provinz, Kontinent, Subkontinent | | Use 0 or one| Wiedergabeliste, Kanal, Gruppe | | Optional| AbonniertStatus |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

UserActivityByCity

Dieser Bericht bietet Statistiken zur Benutzeraktivität, sortiert nach Stadt.

Tabellenspezifische Informationen

Regeln auswählen

Um Benutzeraktivität nach Stadt abzufragen, müssen Sie Folgendes festlegen: maxResults auf einen ganzzahligen Wert von 250 oder weniger. Sie müssen auch einen Wert für den Sortieranforderungsparameter angeben.

Videoberichte:

Berichte des Inhaltseigentümers:

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

UserActivityByCountry

Dieser Bericht bietet Statistiken zur Benutzeraktivität.

Tabellenspezifische Informationen

Regeln auswählen

Die Benutzeraktivität nach Land kann nur gefiltert werden, um Daten für ein bestimmtes Video zurückzugeben.

Videoberichte:

| Abmessungen | Erforderlich | Land | | -------------- | ------------------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, rote Ansichten, Kommentare, „Gefällt mir“, „Gefällt mir nicht“, „Zu Playlists hinzugefügte Videos“, „Aus Playlists entfernte Videos“, Shares, geschätzte angesehene Minuten, geschätzte angesehene rote Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, Annotation-Klickrate, Annotation-Schließrate, Annotation-Impressionen, Annotation-klickbare Impressionen, Annotation-schließbare Impressionen, Annotation-Klicks, Annotation-Schließungen, Kartenklickrate, Kartenteaser-Klickrate, Kartenimpressionen, Kartenteaser-Impressionen, Kartenklicks, Kartenteaser-Klicks, gewonnene Abonnenten, verlorene Abonnenten, geschätzter Umsatz*, geschätzter Anzeigenumsatz*, Bruttoumsatz*, geschätzter roter Partnerumsatz*, monetarisierte Wiedergaben*, wiedergabebasierter CPM*, Anzeigenimpressionen*, CPM* | | Filter | Verwenden Sie 0 oder 1 | Kontinent, Subkontinent | | Use 0 or 1| Video, Gruppe |

Playlist-Berichte:

| Dimensionen | Erforderlich | Land | | --------------- | -------------------------------- | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, rote Ansichten, geschätzte angesehene Minuten, geschätzte rote angesehene Minuten, durchschnittliche Ansichtsdauer, Wiedergabelistenstarts, Ansichten pro Wiedergabelistenstart, durchschnittliche Zeit in der Wiedergabeliste | | Filter | Erforderlich | isCurated==1 | | Use 0 or 1| Kontinent, Subkontinent | | Use 0 or 1| Wiedergabeliste, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Berichte des Inhaltseigentümers:

| Dimensionen | Erforderlich | Land | | -------------- | --------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, rote Ansichten, Kommentare, „Gefällt mir“, „Gefällt mir nicht“, „Zu Playlists hinzugefügte Videos“, „Aus Playlists entfernte Videos“, Shares, geschätzte angesehene Minuten, geschätzte angesehene rote Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, Annotation-Klickrate, Annotation-Schließrate, Annotation-Impressionen, Annotation-klickbare Impressionen, Annotation-schließbare Impressionen, Annotation-Klicks, Annotation-Schließungen, Kartenklickrate, Kartenteaser-Klickrate, Kartenimpressionen, Kartenteaser-Impressionen, Kartenklicks, Kartenteaser-Klicks, gewonnene Abonnenten, verlorene Abonnenten, geschätzter Umsatz*, geschätzter Anzeigenumsatz*, Bruttoumsatz*, geschätzter roter Partnerumsatz*, monetarisierte Wiedergaben*, wiedergabebasierter CPM*, Anzeigenimpressionen*, CPM* | | Filter | Verwenden Sie genau 1 | Video, Kanal, Gruppe oder eine unterstützte Kombination aus UploaderType und ClaimedStatus | | Use 0 or 1| Kontinent, Subkontinent |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

UserActivityByProvince

Dieser Bericht bietet Statistiken zur Benutzeraktivität, sortiert nach Provinz (einschließlich Washington DC).

Tabellenspezifische Informationen

Regeln auswählen

Benutzeraktivität nach Provinz gilt für US-Bundesstaaten und den District of Columbia. Für die Provinz müssen Sie den Parameterwert filters auf country==US.

Videoberichte:

| Abmessungen | Erforderlich | Provinz | | -------------- | ------------------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, rote Ansichten, geschätzte beobachtete Minuten, geschätzte rote beobachtete Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, AnnotationClickThroughRate, AnnotationCloseRate, AnnotationImpressions, AnnotationClickableImpressions, AnnotationClosableImpressions, AnnotationClicks, AnnotationCloses, Kartenklickrate, Kartenteaserklickrate, Karteneindrücke, Kartenteasereindrücke, Kartenklicks, Kartenteaserklicks | | Filter | Erforderlich | Land==US | | Use 0 or 1| Video, Gruppe |

Playlist Reports: Dieser Bericht bietet Statistiken zur Playlist-Aktivität für US-Bundesstaaten und Washington DC. Für diesen Bericht müssen Sie Folgendes angeben: country==US im Parameterwert Filter.

| Dimensionen | Erforderlich | Provinz | | --------------- | -------------------------------- | | Use 0 or more| AbonniertStatus, YouTubeProdukt | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, rote Ansichten, geschätzte angesehene Minuten, geschätzte rote angesehene Minuten, durchschnittliche Ansichtsdauer, Wiedergabelistenstarts, Ansichten pro Wiedergabelistenstart, durchschnittliche Zeit in der Wiedergabeliste | | Filter | Erforderlich | isCurated==1;country==US | | Use 0 or 1| Kontinent, Subkontinent | | Use 0 or 1| Wiedergabeliste, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Berichte des Inhaltseigentümers:

| Dimensionen | Erforderlich | Provinz | | -------------- | ------------------- | | Optional| Inhaltstyp des Erstellers | | Metriken | Verwenden Sie 1 oder mehr | Ansichten, rote Ansichten, geschätzte beobachtete Minuten, geschätzte rote beobachtete Minuten, durchschnittliche Ansichtsdauer, durchschnittlicher Ansichtsprozentsatz, AnnotationClickThroughRate, AnnotationCloseRate, AnnotationImpressions, AnnotationClickableImpressions, AnnotationClosableImpressions, AnnotationClicks, AnnotationCloses, Kartenklickrate, Kartenteaserklickrate, Karteneindrücke, Kartenteasereindrücke, Kartenklicks, Kartenteaserklicks | | Filter | Verwenden Sie genau 1 | Video, Kanal, Gruppe oder eine unterstützte Kombination aus UploaderType und ClaimedStatus | | Required| Land==USA |

Berichte zu Playlists von Inhaltseigentümern:

| Dimensionen | Erforderlich | Provinz | | --------------- | -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -- | | Use 0 or more| Abonniertstatus, geschätzte Betrachtungsminuten, geschätzte rote Betrachtungsminuten, durchschnittliche Anzeigedauer, Wiedergabelistenstarts, Ansichten pro Wiedergabelistenstart, durchschnittliche Zeit in der Wiedergabeliste | | Filter | Erforderlich | isCurated==1;country==US | | Use 0 or 1| Wiedergabeliste, Kanal, Gruppe | | Use 0 or more| AbonniertStatus, YouTubeProdukt |

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

VideoAbuseReportReasons

YouTube VideoAbuseReportReasons abfragen. Eine VideoAbuseReportReason-Ressource enthält Informationen zu einem Grund, warum ein Video als missbräuchlich gekennzeichnet werden würde.

Tabellenspezifische Informationen

Auswählen

Für diese Tabelle sind keine Filter erforderlich. Eine optionale Spalte ist Sprache.

Der Operator '=' wird für diese Spalte unterstützt.

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

VideoCategories

YouTube VideoCategories abfragen. Eine VideoCategory-Ressource identifiziert eine Kategorie, die mit hochgeladenen Videos verknüpft wurde oder verknüpft werden könnte.

Tabellenspezifische Informationen

Auswählen

Sie können genau eine der folgenden Spalten angeben: ID oder Region. Wenn Sie keine Filterkriterien angeben, erhalten Sie standardmäßig Ergebnisse für die Region USA. Ein zusätzlicher optionaler Parameter ist Sprache.

SELECT * FROM VideoCategories WHERE Region = 'JP'

Der IN-Operator kann zum Filtern nach mehreren IDs verwendet werden:

SELECT Id, Kind, Etag, ChannelId, Title, Assignable
FROM   VideoCategories
WHERE  (ID IN ('1', '2', '10'))

Spalten

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Videos

YouTube-Videos abfragen.

Tabellenspezifische Informationen

Auswählen

Standardmäßig SupportEnhancedSQL ist auf true gesetzt und das Folgende wird an YouTube Analytics übergeben, falls vorhanden. Andere Filter werden clientseitig ausgeführt. Wenn SupportEnhancedSQL auf „False“ gesetzt ist, werden nur die folgenden Filter berücksichtigt.

Wenn keine Filter angegeben sind, gibt der Treiber standardmäßig alle Videos zurück, die dem authentifizierten Benutzer gehören.

Es kann immer nur nach einer der folgenden Spalten gefiltert werden: Id, MyRating, ChannelId oder Chart. Weitere unterstützte Spalten sind ForMine, Language, ForContentOwner und OnBehalfOfContentOwner.

Eine Suche in allen Videos auf YouTube kann durch die Angabe von Suchbegriffen, RelatedToVideoId, VideoDuration, VideoCategoryId oder Region ausgeführt werden.

Alle Spalten unterstützen den Operator „=“. PublishedAt unterstützt außerdem diese zusätzlichen Operatoren: „>“, „>=“, „<“ und „<=“. ID und ChannelId unterstützen IN.

Die Option „Sortieren nach“ wird für die Spalten „Datum“, „Bewertung“, „Relevanz“ und „Titel“ unterstützt.

SELECT * FROM Videos WHERE Id = '12345679'

SELECT * FROM Videos WHERE PublishedAt >= '2016-01-01T20:30:00Z' LIMIT 10
SELECT Description FROM Videos WHERE ForMine = True ORDER BY Date

Hinweis: Die Sortierung wird nicht unterstützt, wenn eine der Spalten angegeben wird, die für die Suche nach Kanälen verwendet werden, z. B. Suchbegriffe.

Der IN-Operator kann verwendet werden, um eine Liste von Kanälen anzugeben. Dieser Aufruf gibt eine Liste von Videos für jeden angegebenen Kanal zurück.

SELECT * FROM Videos WHERE ChannelId IN (a, b, c)
SELECT * FROM Videos WHERE ChannelId IN (SELECT ID FROM Channels)

Der IN-Operator kann auch zum Abrufen von Daten für mehrere Videos verwendet werden.

SELECT * FROM Videos WHERE ID IN (a, b, c)

Spalten

Name	Typ	Dimension	Standardmetrik	Standarddimension	Beschreibung
Id [KEY]	String				Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet.
ChannelId	String				Die ID, die YouTube verwendet, um den Kanal eindeutig zu identifizieren, auf den das Video hochgeladen wurde.
CategoryId	String				Die mit dem Video verknüpfte YouTube-Videokategorie.
Title	String				Der Titel des Videos.
ChannelTitle	String				Kanaltitel für den Kanal, zu dem das Video gehört.
PublishedAt	Datetime				Datum und Uhrzeit der Veröffentlichung des Videos. Beachten Sie, dass diese Uhrzeit möglicherweise nicht mit der Uhrzeit übereinstimmt, zu der das Video hochgeladen wurde. Der Wert wird im ISO 8601-Format (JJJJ-MM-TTThhss.sZ) angegeben.
Description	String				Die Beschreibung des Videos.
Duration	String				Die Länge des Videos. Der Eigenschaftswert ist eine Dauer gemäß ISO 8601.
ViewCount	Long				Die Häufigkeit, mit der das Video aufgerufen wurde.
LikeCount	Long				Die Anzahl der Benutzer, die angegeben haben, dass ihnen das Video gefallen hat.
DislikeCount	Long				Die Anzahl der Benutzer, die angegeben haben, dass ihnen das Video nicht gefallen hat. In Verbindung mit Änderungen, die die Anzahl der Video-Abneigungen auf der gesamten YouTube-Plattform privat machen, wird dieses Feld nur zurückgegeben, wenn die API Anforderung vom Videobesitzer authentifiziert wurde.
CommentCount	Long				Die Anzahl der Kommentare zum Video.
EmbedHtml	String				Ein Iframe-Tag, der einen Player einbettet, der das Video abspielt.
PublicStatsViewable	Boolean				Dieser Wert gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite öffentlich sichtbar sind. Standardmäßig sind diese Statistiken sichtbar und Statistiken wie die Anzahl der Aufrufe und Bewertungen sind auch dann öffentlich sichtbar, wenn dieser Wert auf „false“ gesetzt ist.
TagsAggregate	String				Eine Liste mit Stichwort-Tags, die mit dem Video verknüpft sind.
LiveBroadcastContent	String				Gibt an, ob es sich bei dem Video um eine bevorstehende/aktive Live-Übertragung handelt. Der Wert „Keine“ bedeutet, dass es sich bei dem Video nicht um eine bevorstehende/aktive Live-Übertragung handelt. Gültige Werte für diese Spalte: live, keine, bevorstehend.
Dimension	String				Gibt an, ob das Video in 3D oder 2D verfügbar ist.
Definition	String				Gibt an, ob das Video in High Definition HD oder nur in Standardauflösung verfügbar ist. Gültige Werte für diese Spalte: hd, sd.
Caption	String				Gibt an, ob Untertitel für das Video verfügbar sind. Gültige Werte für diese Spalte: false, true.
LicensedContent	Boolean				Gibt an, ob es sich bei dem Video um lizenzierten Inhalt handelt, d. h., der Inhalt wurde auf einen mit einem YouTube-Inhaltspartner verknüpften Kanal hochgeladen und anschließend von diesem Partner beansprucht.
AllowedAggregate	String				Eine Liste mit Regionalcodes, die die Länder identifizieren, in denen das Video angesehen werden kann.
BlockedAggregate	String				Eine Liste mit Regionalcodes, die die Länder identifizieren, in denen das Video gesperrt ist.
Projection	String				Gibt das Projektionsformat des Videos an. Gültige Werte: 360, rechteckig.
PrivacyStatus	String				Der Datenschutzstatus der Wiedergabeliste. Gültige Werte: privat, öffentlich, nicht gelistet.
MadeForKids	Boolean				Dieser Wert gibt an, ob das Video speziell für Kinder ist.
License	String				Die Lizenz. Gültige Werte: creativeCommon, youtube.
Embeddable	Boolean				Dieser Wert gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
ThumbnailsDefaultUrl	String				Die URL des Standardbildes.
DefaultLanguage	String				Diese Spalte ist für vertrauenswürdige Tester vertraulich. Die Sprache des Textes in den Spalten „Titel“ und „Beschreibung“.
DefaultAudioLanguage	String				Die Spalte „default_audio_language“ gibt die Sprache an, die in der Standard-Audiospur des Videos gesprochen wird.
UploadStatus	String				Der Status des hochgeladenen Videos. Gültige Werte für diese Spalte: gelöscht, fehlgeschlagen, verarbeitet, abgelehnt, hochgeladen.
FailureReason	String				Dieser Wert erklärt, warum das Hochladen eines Videos fehlgeschlagen ist. Diese Spalte hat nur dann einen Wert, wenn die Spalte UploadStatus angibt, dass der Upload fehlgeschlagen ist. Gültige Werte für diese Spalte: Codec, Conversion, EmptyFile, InvalidFile, TooSmall, UploadAborted.
RejectionReason	String				Dieser Wert erklärt, warum YouTube ein hochgeladenes Video abgelehnt hat. Diese Spalte hat nur dann einen Wert, wenn die Spalte UploadStatus angibt, dass der Upload abgelehnt wurde. Gültige Werte für diese Spalte: Anspruch, Urheberrecht, Duplikat, unangemessen, Länge, Nutzungsbedingungen, Warenzeichen, UploaderAccountClosed, UploaderAccountSuspended.
RecordingDate	Datetime				Datum und Uhrzeit der Videoaufzeichnung. Der Wert wird im ISO 8601-Format (JJJJ-MM-TThhss.sssZ) angegeben.
SearchTerms	String				Der zu suchende Abfrage.

Pseudo-Spalten

Pseudo-Spaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit YouTube Analytics hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von YouTube Analytics zurück, zusammen mit einem Hinweis, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Gespeicherte Prozeduren im YouTube Analytics Connector

Benutzerdefiniertes Schema erstellen

Erstellt eine benutzerdefinierte Schema basierend auf den angegebenen Dimensionen und Metriken.

CreateCustomSchema

Erstellt eine benutzerdefinierte Schema basierend auf den angegebenen Dimensionen und Metriken.

Für einen maßgeschneiderten Ansatz zu Ihren Daten kann ein benutzerdefiniertes Schema verwendet werden. Benutzerdefinierte Optionen können durch Kommas getrennte Listen für bestimmte Daten enthalten.

Eingabe

Ergebnissatzspalten

GetOAuthAccessToken

Erhält den OAuth-Zugriffstoken, der zur Authentifizierung bei verschiedenen Google-Diensten verwendet werden soll.

Input

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die OAuth-Autorisierungs URL ab, die für die Authentifizierung bei verschiedenen Google-Diensten verwendet wird.

Eingabe

Ergebnissatzspalten

RefreshOAuthAccessToken

Erhält den OAuth-Zugriffstoken, der zur Authentifizierung bei verschiedenen Google-Diensten verwendet werden soll.

Input

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für YouTube Analytics zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Groups“ zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Groups'

Spalten

sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur „RefreshOAuthAccessToken“ zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='RefreshOAuthAccessToken' AND Direction=1 OR Direction=2