Leitfaden zur Drive API V2

Wenn Sie die Google Drive API Version 2 verwenden, beziehen sich die meisten Inhalte im Leitfaden zur Google Drive API Version 3 auch auf Version 2. Dieser Abschnitt enthält alle Informationen, die speziell für Version 2 gelten und sich von den Informationen auf bestimmten Seiten des Leitfadens für Version 3 unterscheiden. Jeder Unterabschnitt enthält einen Link zur entsprechenden Anleitungsseite.

Eine vollständige Liste der Unterschiede finden Sie in der Vergleichsreferenz für Drive API v2 und v3.

Dateiüberarbeitungen herunterladen und veröffentlichen

Auf der Seite Dateiversionen herunterladen und veröffentlichen sind die folgenden Informationen nur für Version 2 relevant und ersetzen die folgenden Abschnitte, die für Version 3 angezeigt werden:

Einzelne Versionen auflisten und herunterladen

Nachdem Sie eine Liste der Versionen einer Datei erhalten haben, können Sie den Inhalt einer beliebigen Version herunterladen, indem Sie eine autorisierte GET-Anfrage an die Property []downloadUrl](/drive/api/reference/rest/v2/revisions) senden. Diese kurzlebige URL wird von Google Drive generiert, wenn Sie die Überarbeitung anfordern. Sie können sich nicht darauf verlassen, dass sie später noch verfügbar sind.

Sie können die Version auch in einem der unterstützten Formate exportieren, indem Sie das Attribut exportLinks aktivieren.

Benutzerdefinierte Dateieigenschaften

Zusätzlich zu den Informationen auf der Seite Benutzerdefinierte Dateieigenschaften hinzufügen gelten für Version 2 die folgenden Informationen:

Der Zugriff auf Properties erfolgt über die Ressource properties.

Das ist die Struktur einer typischen Property, die zum Speichern der Datenbank-ID einer Drive-Datei in der Datei verwendet werden kann.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

Weitere Informationen zu Limits finden Sie in der Referenzdokumentation unter properties.

Unterstützung für geteilte Ablagen aktivieren

Zusätzlich zu den Informationen auf der Seite Unterstützung für freigegebene Laufwerke implementieren ersetzen Sie dieses zusätzliche Feld trashedDate durch „v2“.

Unter Unterstützung für geteilte Ablagen implementieren ist für die folgenden Methoden supportsAllDrives=true erforderlich, wenn Sie mit Inhalten in geteilten Ablagen arbeiten:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

Die Methoden changes.get und changes.list haben mehrere Parameter, die speziell für freigegebene Laufwerke gelten. Eine Liste der Parameter finden Sie im Abschnitt Änderungen in einer geteilten Ablage im Blick behalten.

Dateien hochladen

Die folgenden Informationen auf der Seite Dateidaten hochladen beziehen sich auf Version 2:

In Google Docs-Typen importieren

Wenn Sie eine Datei in Google Drive erstellen, können Sie einige Dateitypen in ein Google Docs-, Google Tabellen- oder Google Präsentationen-Dokument umwandeln. Fügen Sie die Abfrageparameter files.insert convert hinzu und legen Sie das Attribut „workspace_name“ mimeType der Datei fest. Weitere Informationen finden Sie unter Daten hochladen.

Dateien, Ordner und Laufwerke freigeben

Hinweis auf der Seite Dateien, Ordner und Laufwerke freigeben: In Version 3 werden in nur einem Feld, role, die effektiven Rollen für Nutzer, Gruppen oder Domains angegeben. In Version 2 müssen sowohl das Feld role als auch das Feld additionalRoles einer Berechtigung die effektiven Rollen widerspiegeln, die der Nutzer, die Gruppe oder die Domain für ein bestimmtes Element hat.

Unterschiede bei Suchanfragen für Version 2

Das Feld title in Version 2 ist name in Version 3. Beispiele finden Sie unter Dateien und Ordner suchen.

Das Feld createdDate in Version 2 ist createdTime in Version 3. Beispiele finden Sie unter Nach freigegebenen Laufwerken suchen.

Das Feld modifiedDate in Version 2 ist modifiedTime in Version 3. Das Feld lastViewedByMeDate in Version 2 heißt in Version 3 viewedByMeTime. Weitere Informationen finden Sie unter Suchbegriffe und Suchoperatoren.