Leitfaden zur Drive API V2

Wenn Sie Version 2 der Google Drive API verwenden, beziehen sich die meisten Inhalte des Leitfadens für Google Drive-APIs Version 3 auch auf Version 2. 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. Um den vollständigen Kontext zu erhalten, enthält jeder Unterabschnitt einen Link zur entsprechenden Anleitungsseite.

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

Dateiüberarbeitungen herunterladen und veröffentlichen

Die folgenden Informationen auf der Seite Dateiüberarbeitungen herunterladen und veröffentlichen beziehen sich speziell auf v2 und ersetzen die für v3 gezeigten Abschnitte:

Einzelne Überarbeitungen auflisten und herunterladen

Wenn Sie eine Liste der Überarbeitungen einer Datei erhalten, können Sie den Inhalt einer Ü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 für die spätere Verwendung darauf.

Sie können die Überarbeitung auch in einem der unterstützten Formate exportieren. Klicken Sie dazu auf das Attribut exportLinks.

Benutzerdefinierte Dateieigenschaften

Neben 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 einer typischen Property, mit der 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 für geteilte Ablagen implementieren ist für die folgenden Methoden die supportsAllDrives=true erforderlich, wenn Sie mit Inhalten aus 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 für geteilte Ablagen spezifisch sind. Eine Liste der Parameter finden Sie im Abschnitt Änderungen in einer geteilten Ablage verfolgen.

Dateien hochladen

Beachten Sie auf der Seite Dateidaten hochladen, dass diese Informationen v2-spezifisch sind:

In Google Docs 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 konvertieren. Fügen Sie die convert-Abfrageparameter files.insert ein und legen Sie das Attribut mimeType der Datei (workspace_name) 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 gültigen Rollen für Nutzer, Gruppe oder Domain angibt. In v2 benötigen Sie die Felder role und additionalRoles einer Berechtigung, die die effektiven Rollen des Nutzers, der Gruppe oder der Domain für ein bestimmtes Element widerspiegeln.

Unterschiede bei Suchanfragen für Version 2

Das Feld title von Version 2 ist in Version 3 auf name gesetzt. Beispiele finden Sie unter Nach Dateien und Ordnern suchen.

Das Feld createdDate von Version 2 ist in Version 3 auf createdTime gesetzt. Beispiele finden Sie unter Nach geteilten Ablagen suchen.

Das Feld modifiedDate von Version 2 ist in Version 3 auf modifiedTime gesetzt. Das Feld lastViewedByMeDate von V2 ist in Version 3 viewedByMeTime. Weitere Informationen finden Sie unter Suchbegriffe und Operatoren.