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 z odpowiedzią na performance.updateMulti 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ść jest zawsze stałym ciągiem znaków games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Zaktualizowany stan osiągnięć.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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 żądań aktualizacji osiągnięć.

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

string

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

object (UpdateAchievement)

Pojedyncze żądania aktualizacji osiągnięć.

UpdateAchievement

Prośba o zaktualizowanie 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ść jest zawsze stałym ciągiem znaków games#achievementUpdateRequest.
achievementId

string

Osiągnięcie, do którego stosowana 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 zostaje ujawnione.
UNLOCK Osiągnięcie jest odblokowane.
INCREMENT Osiągnięcia zwiększą się.
SET_STEPS_AT_LEAST Postęp w osiągnięciu jest ustawiony na co najmniej przekazaną wartość.

AchievementIncrement

Ładunek, o który prosisz, aby zwiększyć osiągnięcie.

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

string

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

integer

Liczba kroków do zwiększenia.
requestId

string (int64 format)

Identyfikator żądania powiązany z przyrostem do osiągnięcia.

SetAchievementSteps

Ładunek, o który prosisz, aby zwiększyć osiągnięcie.

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

string

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

integer

Minimalna liczba kroków, które należy ustawić dla 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ść jest zawsze stałym ciągiem znaków games#achievementUpdateResponse.
achievementId

string

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

boolean

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

enum (UpdatedAchievementState)

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

integer

Bieżące kroki zarejestrowane dla tego osiągnięcia, jeśli jest ono przyrostowe.
newlyUnlocked

boolean

Określa, czy osiągnięcie zostało niedawno odblokowane (tzn. czy gracz wysłał pierwszą prośbę o jego odblokowanie).

UpdatedAchievementState

Możliwe zaktualizowane stany osiągnięć.

Wartości w polu enum
HIDDEN Osiągnięcie jest ukryte.
REVEALED Osiągnięcie zostaje ujawnione.
UNLOCKED Osiągnięcie jest odblokowane.