Method: projects.histories.list

Wyświetla listę historii danego projektu.

Historie są posortowane według czasu modyfikacji w kolejności malejącej. Klucz historyId zostanie użyty do uporządkowania historii według tego samego czasu modyfikacji.

Może zwrócić dowolny z tych kanonicznych kodów błędów:

  • PERMISSION_DENIED – jeśli użytkownik nie ma uprawnień do odczytu projektu
  • INVALID_ARGUMENT – jeśli żądanie ma nieprawidłowy format
  • NOT_FOUND – jeśli historia nie istnieje

Żądanie HTTP

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
projectId

string

Identyfikator projektu.

Wymagane.

Parametry zapytania

Parametry
pageToken

string

Token kontynuacji, który pozwala wznowić zapytanie przy następnym elemencie.

Opcjonalnie.
pageSize

integer

Maksymalna liczba historii do pobrania.

Wartość domyślna: 20. Serwer użyje tej wartości domyślnej, jeśli pole nie jest ustawione lub ma wartość 0. Każda wartość większa niż 100 będzie traktowana jako 100.

Opcjonalnie.
filterByName

string

Jeśli jest ustawiona, zwraca tylko historie o podanej nazwie.

Opcjonalnie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat z odpowiedzią na klasy HistoryService.List

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

Zapis JSON 
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
Pola
histories[]

object (History)

Historie.
nextPageToken

string

Token kontynuacji, który pozwala wznowić zapytanie przy następnym elemencie.

Zostanie ustawiona tylko wtedy, gdy do pobrania jest więcej historii.

Tokeny są ważne przez maksymalnie godzinę od momentu wysłania pierwszego żądania wyświetlenia listy. Jeśli na przykład wyślesz żądanie listy o 13:00 i użyjesz tokena z pierwszego żądania 10 minut później, token z drugiej odpowiedzi będzie ważny tylko przez 50 minut.

Zakresy autoryzacji

Wymaga następującego zakresu protokołu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).