Leitfaden zur Drive API V2

Wenn Sie die Google Drive API Version 2 verwenden, bezieht sich der größte Teil des Google Drive API-Leitfadens v3 auch auf v2. Dieser Abschnitt enthält alle Informationen, die für Version 2 spezifisch sind und sich von den Informationen auf bestimmten Seiten des Leitfadens für Version 3 unterscheiden. Jeder Unterabschnitt enthält einen Link zur entsprechenden Anleitungsseite, um vollständigen Kontext zu erhalten.

Eine vollständige Liste der Unterschiede finden Sie in der Vergleichsreferenz für Drive API Version 2 und Version 3.

Dateiüberarbeitungen herunterladen und veröffentlichen

Auf der Seite Dateiüberarbeitungen herunterladen und veröffentlichen beziehen sich die folgenden Informationen speziell auf Version 2 und ersetzen die für Version 3 aufgeführten Abschnitte:

Einzelne Überarbeitungen auflisten und herunterladen

Nachdem Sie eine Liste der Überarbeitungen einer Datei abgerufen haben, können Sie den Inhalt jeder Überarbeitung herunterladen. Senden Sie dazu eine autorisierte GET-Anfrage an das Attribut []downloadUrl](/drive/api/reference/rest/v2/revisions). Google Drive generiert diese kurzlebige URL, wenn Sie die Überarbeitung anfordern. Verlassen Sie sich nicht auf sie für die spätere Verwendung.

Sie können die Überarbeitung auch in einem der unterstützten Formate exportieren. Dazu klicken Sie das Attribut exportLinks an.

Benutzerdefinierte Dateieigenschaften

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

Der Zugriff auf Attribute erfolgt über die Ressource properties.

Dies ist die Struktur eines typischen Attributs, mit dem die Datenbank-ID einer Drive-Datei in der Datei gespeichert 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

Ersetzen Sie zusätzlich zu den Informationen auf der Seite Unterstützung für geteilte Ablagen implementieren das zusätzliche Feld trashedDate für Version 2.

Unter Unterstützung geteilter Ablagen implementieren ist für die folgenden Methoden supportsAllDrives=true erforderlich, wenn Sie mit Inhalten von 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 speziell für geteilte Ablagen. Eine Liste der Parameter finden Sie im Abschnitt Änderungen an einer geteilten Ablage im Blick behalten.

Dateien hochladen

Auf der Seite Dateidaten hochladen gelten die folgenden Informationen speziell für v2:

In Google Docs-Typen importieren

Wenn Sie eine Datei in Google Drive erstellen, können Sie bestimmte Dateitypen in ein Google Docs-, Google Tabellen- oder Google Präsentationen-Dokument konvertieren. Fügen Sie die Abfrageparameter files.insert convert hinzu und legen Sie die Eigenschaft (workspace_name) mimeType der Datei fest. Weitere Informationen finden Sie unter Dateidaten hochladen.

Dateien, Ordner und Ablagen freigeben

Beachten Sie, dass auf der Seite Dateien, Ordner und Laufwerke freigeben in Version 3 nur das Feld role die geltenden Rollen für Nutzer, Gruppe oder Domain angibt. In Version 2 müssen die Felder role und additionalRoles einer Berechtigung die geltenden Rollen widerspiegeln, die der Nutzer, die Gruppe oder die Domain für ein bestimmtes Element haben.

Unterschiede bei Suchanfragen für Version 2

Das v2-Feld title ist in v3 name. Beispiele finden Sie unter Nach Dateien und Ordnern suchen.

Das v2-Feld createdDate ist in v3 createdTime. Beispiele finden Sie unter Nach geteilten Ablagen suchen.

Das v2-Feld modifiedDate ist in v3 modifiedTime. Das V2-Feld lastViewedByMeDate ist in Version 3 viewedByMeTime. Weitere Informationen finden Sie unter Suchbegriffe und Operatoren.