Method: achievements.updateMultiple

Aktualizuje wiele osiągnięć dla obecnie uwierzytelnionego gracza.

Żądanie HTTP

POST https://games.googleapis.com/games/v1/achievements/updateMultiple

Treść żądania

Treść żądania zawiera wystąpienie elementu UpdateMultipleAchievements.

Treść odpowiedzi

Komunikat odpowiedzi na temat constraints.updateMultiple rpc.

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

Zapis JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Zaktualizowany stan osiągnięć.

Zakresy autoryzacji

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

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateMultipleAchievements

Lista próśb o aktualizację osiągnięć.

Zapis JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Prośba o aktualizację osiągnięć danego użytkownika.

UpdateAchievement

Żądanie zaktualizowania osiągnięcia.

Zapis JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#achievementUpdateRequest.
achievementId

string

Osiągnięcie, do którego wprowadzana jest ta aktualizacja.
updateType

enum (AchievementUpdateType)

Typ stosowanej aktualizacji.
incrementPayload

object (AchievementIncrement)

Ładunek, jeśli zażądano aktualizacji typu INCREMENT dla osiągnięcia.
setStepsAtLeastPayload

object (SetAchievementSteps)

Ładunek, jeśli zażądano aktualizacji typu SET_STEPS_AT_LEAST dla osiągnięcia.

AchievementUpdateType

Możliwe typy aktualizacji osiągnięć.

Wartości w polu enum
REVEAL Osiągnięcie jest widoczne.
UNLOCK Osiągnięcie zostało odblokowane.
INCREMENT Osiągnięcie jest zwiększane.
SET_STEPS_AT_LEAST Postęp osiągnięć jest ustawiony na co najmniej przekazaną wartość.

AchievementIncrement

Ładunek, który ma być wysyłany, aby zwiększyć osiągnięcie.

Zapis JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#GamesAchievementIncrement.
steps

integer

Liczba kroków do zwiększenia.
requestId

string (int64 format)

Identyfikator żądania powiązany z zwiększeniem wartości osiągnięcia.

SetAchievementSteps

Ładunek, który ma być wysyłany, aby zwiększyć osiągnięcie.

Zapis JSON 
{
  "kind": string,
  "steps": integer
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#GamesAchievementSetStepsAtLeast.
steps

integer

Minimalna liczba kroków wymagana do ustawienia osiągnięcia.

UpdatedAchievement

Zaktualizowane osiągnięcie.

Zapis JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#achievementUpdateResponse.
achievementId

string

Osiągnięcie, do którego zastosowano tę aktualizację.
updateOccurred

boolean

Wskazuje, czy żądane aktualizacje faktycznie wpłynęły na osiągnięcie.
currentState

enum (UpdatedAchievementState)

Bieżący stan osiągnięcia.
currentSteps

integer

Liczba bieżących kroków zarejestrowanych w przypadku tego osiągnięcia, jeśli jest przyrostowa.
newlyUnlocked

boolean

Określa, czy osiągnięcie zostało niedawno odblokowane (tzn. czy prośba o odblokowanie osiągnięcia była pierwsza w przypadku danego gracza).

UpdatedAchievementState

Możliwe zaktualizowane stany osiągnięć.

Wartości w polu enum
HIDDEN Osiągnięcie jest ukryte.
REVEALED Osiągnięcie jest widoczne.
UNLOCKED Osiągnięcie zostało odblokowane.