Leitfaden zur 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 unter Vergleich der Drive API Version 2 und Version 3 Referenz.

Dateirevisionen herunterladen und veröffentlichen

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

Einzelne Revisionen auflisten und herunterladen

Sobald Sie eine Liste der Revisionen einer Datei erhalten haben, können Sie den Inhalt einer beliebigen Revision 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 Revision anfordern. Sie sollte nicht für die spätere Verwendung gespeichert werden.

Sie können die Revision 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.

In 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 Abfrage parameter ein und legen Sie die Eigenschaft mimeType 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 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 finden Sie unter Nach Dateien und Ordnern suchen.

Das Feld createdDate in Version 2 ist in Version 3 createdTime. Beispiele finden Sie unter Nach geteilten 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.