Leitfaden zur Drive API V2

Wenn Sie die Google Drive API Version 2 verwenden, gilt der Großteil der Inhalte im Google Drive API-Leitfaden Version 3 auch für Version 2. Dieser Abschnitt enthält alle Informationen, die sich auf Version 2 beziehen und sich von den Informationen auf bestimmten Seiten des Version 3-Leitfadens unterscheiden. Um den vollständigen Kontext zu erhalten, enthält jeder Unterabschnitt den Link zur entsprechenden Hilfeseite.

Eine vollständige Liste der Unterschiede finden Sie im Vergleich der Drive API-Versionen 2 und 3.

Dateiversionen herunterladen und veröffentlichen

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

Einzelne Überarbeitungen auflisten und herunterladen

Sobald Sie eine Liste der Revisionen einer Datei erhalten haben, können Sie den Inhalt einer beliebigen Revision herunterladen, indem Sie eine autorisierte GET-Anfrage an die Eigenschaft downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) senden. Diese kurzlebige URL wird von Google Drive generiert, wenn Sie die Überarbeitung anfordern. Verlassen Sie sich nicht darauf, dass Sie sie später noch einmal benötigen.

Sie können die Überarbeitung 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 gilt für Version 2 Folgendes:

Auf Properties wird über die properties-Ressource zugegriffen.

Dies 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 zu properties.

Unterstützung für geteilte Ablagen aktivieren

Zusätzlich zu den Informationen auf der Seite Unterstützung für freigegebene Ablagen implementieren müssen Sie für Version 2 dieses zusätzliche Feld trashedDate ersetzen.

In 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 Ablagen gelten. Eine Liste der Parameter finden Sie im Abschnitt Änderungen an einer geteilten Ablage ansehen.

Dateien hochladen

Beachten Sie auf der Seite Dateidaten hochladen, dass die folgenden Informationen speziell für Version 2 gelten:

In Google Docs-Typen importieren

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

Dateien, Ordner und Laufwerke freigeben

Auf der Seite Dateien, Ordner und Ablagen freigeben wird in Version 3 nur ein Feld, role, verwendet, um die effektiven Rollen für Nutzer, Gruppen oder Domains anzugeben. In Version 2 müssen sowohl die Felder role als auch additionalRoles einer Berechtigung die effektiven Rollen widerspiegeln, die der Nutzer, die Gruppe oder die Domain für ein bestimmtes Element haben.

Unterschiede bei Suchanfragen für Version 2

Das Feld title in Version 2 ist in Version 3 name. Beispiele

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

Das Feld modifiedDate in Version 2 ist in Version 3 modifiedTime. Das Feld lastViewedByMeDate in Version 2 ist in Version 3 viewedByMeTime. Weitere Informationen finden Sie unter Suchbegriffe und ‑operatoren.