REST Resource: approvals

Zasób: Approval

Metadane dotyczące zatwierdzenia. Zatwierdzenie to proces sprawdzania lub zatwierdzania elementu na Dysku.

Zapis JSON 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Pola
kind

string

Jest to zawsze drive#approval.
approvalId

string

Identyfikator zatwierdzenia.
targetFileId

string

Identyfikator pliku docelowego zatwierdzenia.
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia zatwierdzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
modifyTime

string (Timestamp format)

Tylko dane wyjściowe. Ostatnia modyfikacja zatwierdzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

Tylko dane wyjściowe. Czas zakończenia zatwierdzania.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
dueTime

string (Timestamp format)

Czas, w którym należy dokonać zatwierdzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
status

enum (Status)

Tylko dane wyjściowe. Stan zatwierdzenia w momencie przesłania prośby o ten zasób.
initiator

object (User)

Użytkownik, który poprosił o zatwierdzenie.
reviewerResponses[]

object (ReviewerResponse)

Odpowiedzi osób weryfikujących treści na prośbę o zatwierdzenie.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Tylko dane wyjściowe. Działanie zatwierdzenia w przypadku zmiany treści pliku.

Stan

Możliwe stany zatwierdzenia.

Wartości w polu enum
STATUS_UNSPECIFIED Stan zatwierdzenia nie został ustawiony lub ma nieprawidłową wartość.
IN_PROGRESS Proces zatwierdzania się rozpoczął, ale nie został jeszcze zakończony.
APPROVED Proces zatwierdzania został zakończony, a miejsce docelowe zostało zatwierdzone.
CANCELLED Proces zatwierdzania został anulowany przed zakończeniem.
DECLINED Proces zatwierdzania został zakończony, a miejsce docelowe zostało odrzucone.

ReviewerResponse

Odpowiedź na zatwierdzenie przesłane przez konkretnego weryfikatora.

Zapis JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
Pola
kind

string

Jest to zawsze drive#reviewerResponse.
reviewer

object (User)

Użytkownik odpowiedzialny za tę odpowiedź.
response

enum (Response)

Odpowiedź weryfikatora dotycząca zatwierdzenia.

Odpowiedź

Możliwe odpowiedzi na prośbę o zatwierdzenie.

Wartości w polu enum
RESPONSE_UNSPECIFIED Odpowiedź została ustawiona na nierozpoznaną wartość.
NO_RESPONSE Weryfikator nie odpowiedział.
APPROVED Weryfikator zatwierdził produkt.
DECLINED Osoba sprawdzająca odrzuciła produkt.

FileContentChangeBehavior

Działanie zatwierdzenia, gdy zawartość pliku zmieni się, a stan zatwierdzenia to [Status][] IN_PROGRESS. Po zakończeniu procesu zatwierdzania to zachowanie nie będzie już występować.

Wartości w polu enum
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED Zachowanie jest nieokreślone.
RESET_APPROVAL Wszystkie ReviewerResponse ze stanem Response ZATWIERDZONO zostaną zresetowane do stanu BRAK_DECYZJI, gdy zawartość pliku zmieni się, a zatwierdzenie będzie miało stan [Status][] W_TOKU. Gdy zatwierdzenie ma [Status][] APPROVED (ZATWIERDZONO) i wybrano RESET_APPROVAL (ZRESETUJ ZATWIERDZENIE), plik jest blokowany.
NO_APPROVAL_ACTION Gdy zawartość pliku ulegnie zmianie, nie są podejmowane żadne działania.

Metody

approve

 Zatwierdza zatwierdzenie.

cancel

 Anuluje zatwierdzenie.

comment

 komentarze dotyczące zatwierdzenia,

decline

 Odrzuca zatwierdzenie.

get

 Pobiera zatwierdzenie według identyfikatora.

list

 Wyświetla listę zatwierdzeń pliku.

reassign

 Ponownie przypisuje osoby weryfikujące do zatwierdzenia.

start

 Rozpoczyna proces zatwierdzania pliku.