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ć uwzględnione w odpowiedzi; serwer próbuje zwrócić co najmniej tę liczbę. Serwer może też zwrócić mniej aktywności, jeśli przed upływem limitu czasu żądania ma gotową odpowiedź częściową. Jeśli nie zostanie ustawiony, zostanie użyta wartość domyślna.
pageToken

string

Token wskazuje, która strona wyników ma zostać zwrócona. Aby uzyskać kolejną stronę wyników, ustaw tę wartość na wartość nextPageToken zwrócona z poprzedniego zapytania. Jeśli zasada nie jest skonfigurowana, zwracana jest pierwsza strona wyników.
filter

string

Filtrowanie elementów zwracanych przez to zapytanie. Format ciągu znaków filtra to sekwencja wyrażeń połączonych opcjonalnym operatorem „ORAZ”, przy czym każde wyrażenie ma postać „wartość operatora pola”.

Obsługiwane pola:

  • time: używa operatorów liczbowych na wartościach daty 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 parametru „has” (:) oraz pojedynczą wartość lub listę dozwolonych typów działań ujętą w nawiasy i oddzieloną spacją. Aby wykluczyć wynik z odpowiedzi, na początku ciągu filtra umieść myślnik (-). Przykłady:

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

string

Zwróć działania związane z tym elementem na Dysku. Format to items/ITEM_ID.
ancestorName

string

Działania związane z zwracaniem dla tego folderu na Dysku oraz wszystkich elementów podrzędnych i podrzędnych. Format to items/ITEM_ID.

Treść odpowiedzi

Komunikat 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)

Żądana lista aktywności.
nextPageToken

string

Token pobierający następną stronę wyników lub pusty, jeśli na liście nie ma więcej wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

ConsolidationStrategy

Sposób konsolidowania poszczególnych aktywności. Jeśli zestaw działań jest powiązany, można go scalić w jedną połączoną aktywność, np. jeden podmiot wykonujący to samo działanie na wielu adresatach lub wiele podmiotów wykonujących to samo działanie na jednym adresacie. 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 sumy strategy. Sposób konsolidowania poszczególnych aktywności. 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 za pomocą starszej strategii.

NoConsolidation

Ten typ nie ma pól.

Strategia, która nie łączy poszczególnych działań.

Starsza wersja

Ten typ nie ma pól.

Strategia konsolidująca działania za pomocą reguł grupowania ze starszej wersji interfejsu Activity API w wersji 1. Podobne działania występujące w określonym oknie czasowym mogą być grupowane w wiele cele (np. przenoszenie zestawu plików naraz) lub wielu wykonawców (np. wielu użytkowników edytujących ten sam element). Reguły grupowania w tej strategii są specyficzne dla każdego typu działania.