Method: activity.query

Wysyłanie zapytań o wcześniejszą aktywność na Dysku Google.

Żądanie HTTP

POST https://driveactivity.googleapis.com/v2/activity:query

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
Pola
consolidationStrategy

object (ConsolidationStrategy)

Szczegóły dotyczące konsolidowania powiązanych działań, które składają się na aktywność. Jeśli nie jest ustawiona, powiązane działania nie są konsolidowane.
pageSize

integer

Minimalna liczba działań, które mają być zawarte w odpowiedzi. Serwer próbuje zwrócić co najmniej tę liczbę. Serwer może też zwrócić mniejszą liczbę działań, jeśli przed upływem limitu czasu żądania ma gotową odpowiedź częściową. Jeśli nie zostanie ustawiona, używana jest wartość domyślna.
pageToken

string

Token określa, która strona wyników ma zostać zwrócona. Ustaw tę wartość na wartość nextPageToken zwróconą z poprzedniego zapytania, aby uzyskać następną stronę wyników. Jeśli nie jest ustawiona, zwracana jest pierwsza strona wyników.
filter

string

Filtrowanie elementów zwracanych w odpowiedzi na to zapytanie. Ciąg filtra to sekwencja wyrażeń połączonych opcjonalnym operatorem „AND”, gdzie każde wyrażenie ma postać „pole operator wartość”.

Obsługiwane pola:

  • time: używa operatorów numerycznych na wartościach dat w milisekundach od 1 stycznia 1970 r. lub w formacie RFC 3339. Przykłady:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: używa operatora „has” (:) oraz pojedynczej wartości lub listy dozwolonych typów działań ujętych w nawiasy i rozdzielonych spacjami. Aby wykluczyć wynik z odpowiedzi, dodaj na początku ciągu filtra łącznik (-). Przykłady:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Pole unii key. Główne kryteria w zapytaniu. Jeśli nie określono klucza, domyślna wartość to ancestorName = items/root. key może mieć tylko jedną z tych wartości:
itemName

string

Zwraca aktywności związane z tym elementem na Dysku. Format to items/ITEM_ID.
ancestorName

string

Zwraca aktywności w tym folderze na Dysku oraz wszystkie elementy podrzędne i pochodne. Format to items/ITEM_ID.

Treść odpowiedzi

Wiadomość z odpowiedzią na zapytanie o aktywność na Dysku.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Pola
activities[]

object (DriveActivity)

Lista zgłoszonych próśb o aktywność.
nextPageToken

string

Token do pobierania następnej strony wyników lub pusty, jeśli na liście nie ma więcej wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.

ConsolidationStrategy

Jak poszczególne działania są konsolidowane. Jeśli zestaw działań jest powiązany, można go połączyć w jedno działanie, np. gdy jeden aktor wykonuje to samo działanie na wielu obiektach docelowych lub gdy wielu aktorów wykonuje to samo działanie na jednym obiekcie docelowym. Strategia określa reguły, według których aktywności są powiązane.

Zapis JSON 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
Pola
Pole unii strategy. Jak poszczególne działania są konsolidowane. strategy może mieć tylko jedną z tych wartości:
none

object (NoConsolidation)

Poszczególne aktywności nie są konsolidowane.
legacy

object (Legacy)

Poszczególne aktywności są konsolidowane przy użyciu starszej strategii.

NoConsolidation

Ten typ nie ma pól.

Strategia, która nie konsoliduje poszczególnych aktywności.

Starsza

Ten typ nie ma pól.

Strategia, która konsoliduje działania przy użyciu reguł grupowania z interfejsu Activity API w starszej wersji 1. Podobne działania występujące w określonym przedziale czasu można grupować w wielu miejscach docelowych (np. przenoszenie zestawu plików naraz) lub w przypadku wielu podmiotów (np. kilku użytkowników edytujących ten sam element). Reguły grupowania w przypadku tej strategii są specyficzne dla każdego typu działania.