Leitfaden für die Drive API V2

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

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

Dateiversionen herunterladen und veröffentlichen

Auf der Seite Dateiversionen herunterladen und veröffentlichen sind die folgenden Informationen spezifisch für Version 2 und ersetzen die für Version 3 angezeigten Abschnitte:

Einzelne Versionen auflisten und herunterladen

Sobald Sie eine Liste der Versionen einer Datei erhalten haben, können Sie den Inhalt einer beliebigen Version herunterladen. Senden Sie dazu eine autorisierte GET-Anfrage an die Eigenschaft []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions). Google Drive generiert diese kurzlebige URL, wenn Sie die Version anfordern. Sie sollte nicht für die spätere Verwendung gespeichert werden.

Sie können die Version auch in einem der unterstützten Formate exportieren, indem Sie die Eigenschaft exportLinks prüfen.

Benutzerdefinierte Dateieigenschaften

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

Auf Eigenschaften wird über die properties Ressource zugegriffen.

Dies ist die Struktur einer typischen Eigenschaft, die verwendet werden kann, um die Datenbank-ID einer Drive-Datei in der Datei zu speichern.

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

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

Unterstützung für geteilte Ablagen aktivieren

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

Unter Unterstützung für geteilte Ablagen implementieren erfordern die folgenden Methoden supportsAllDrives=true, 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 spezifisch für geteilte Ablagen sind. Eine Liste der Parameter finden Sie im Abschnitt Änderungen in einer geteilten Ablage nachverfolgen.

Dateien hochladen

Auf der Seite Dateidaten hochladen sind die folgenden Informationen spezifisch für 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 Sheets- oder Google Präsentationen-Dokument konvertieren. Fügen Sie die files.insert convert Abfrageparameter ein und legen Sie die (workspace_name) mimeType Eigenschaft der Datei fest. Weitere Informationen finden Sie unter Dateidaten hochladen.

Dateien, Ordner und Ablagen freigeben

Auf der Seite Dateien, Ordner und Ablagen freigeben gibt in Version 3 nur ein Feld, role, die effektiven Rollen für Nutzer, Gruppen oder Domains an. In Version 2 müssen die Felder role und 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 heißt in Version 3 name. Beispiele finden Sie unter Nach Dateien und Ordnern suchen.

Das Feld createdDate in Version 2 heißt in Version 3 createdTime. Beispiele finden Sie unter Nach geteilten Ablagen suchen.

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