- HTTP-Anfrage
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ConsolidationStrategy
- NoConsolidation
- Alt
- Testen!
Frühere Aktivitäten in Google Drive abfragen.
HTTP-Anfrage
POST https://driveactivity.googleapis.com/v2/activity:query
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "consolidationStrategy": { object ( |
Felder | |
---|---|
consolidationStrategy |
Details zum Konsolidieren ähnlicher Aktionen, aus denen die Aktivität besteht Ist die Richtlinie nicht konfiguriert, werden zugehörige Aktionen nicht konsolidiert. |
pageSize |
Die Mindestanzahl der in der Antwort gewünschten Aktivitäten. Der Server versucht, mindestens diese Menge zurückzugeben. Der Server gibt möglicherweise auch weniger Aktivitäten zurück, wenn er eine Teilantwort hat, bevor das Zeitlimit für die Anfrage überschritten wird. Wenn nicht festgelegt, wird ein Standardwert verwendet. |
pageToken |
Das Token gibt an, welche Ergebnisseite zurückgegeben werden soll. Geben Sie hier den Wert nextPageToken an, der von einer vorherigen Abfrage zurückgegeben wurde, um die folgende Ergebnisseite zu erhalten. Wenn die Richtlinie nicht konfiguriert ist, wird die erste Ergebnisseite zurückgegeben. |
filter |
Die Filterung nach Elementen, die von dieser Abfrageanfrage zurückgegeben wurden. Das Format des Filterstrings ist eine Abfolge von Ausdrücken, die durch ein optionales „AND“ verbunden sind, wobei jeder Ausdruck die Form „Feldoperatorwert“ hat. Unterstützte Felder:
|
Union-Feld key . Das primäre Kriterium in der Abfrage. Wenn kein Schlüssel angegeben ist, lautet der Standardwert AncestorName = items/root . Für key ist nur einer der folgenden Werte zulässig: |
|
itemName |
Aktivitäten für dieses Drive-Element zurückgeben. Das Format dafür ist |
ancestorName |
Gibt Aktivitäten für diesen Drive-Ordner sowie alle untergeordneten und untergeordneten Elemente zurück. Das Format dafür ist |
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Antwortnachricht für die Abfrage der Drive-Aktivität.
JSON-Darstellung |
---|
{
"activities": [
{
object ( |
Felder | |
---|---|
activities[] |
Liste der angeforderten Aktivitäten. |
nextPageToken |
Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive.activity
https://www.googleapis.com/auth/drive.activity.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
ConsolidationStrategy
Wie die einzelnen Aktivitäten konsolidiert werden Wenn mehrere Aktivitäten in Zusammenhang stehen, können sie zu einer kombinierten Aktivität zusammengefasst werden, z. B. ein Akteur, der dieselbe Aktion für mehrere Ziele ausführt, oder mehrere Akteure, die dieselbe Aktion für ein einzelnes Ziel ausführen. Die Strategie definiert die Regeln, mit denen Aktivitäten zusammenhängen.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld strategy . Wie die einzelnen Aktivitäten konsolidiert werden Für strategy ist nur einer der folgenden Werte zulässig: |
|
none |
Die einzelnen Aktivitäten werden nicht konsolidiert. |
legacy |
Die einzelnen Aktivitäten werden mithilfe der alten Strategie konsolidiert. |
NoConsolidation
Eine Strategie ohne Konsolidierung einzelner Aktivitäten.
Legacy
Eine Strategie, bei der Aktivitäten mithilfe der Gruppierungsregeln aus der alten V1 Activity API konsolidiert werden. Ähnliche Aktionen, die innerhalb eines Zeitfensters ausgeführt werden, können über mehrere Ziele (z. B. eine Reihe von Dateien gleichzeitig) oder von mehreren Akteuren (z. B. mehrere Nutzer, die dasselbe Element bearbeiten) gruppiert sein. Die Gruppierungsregeln für diese Strategie sind für jeden Aktionstyp spezifisch.