REST Resource: edits.tracks

Recurso: Track

A configuração de uma faixa. O recurso para TracksService.

Representação JSON 
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
Campos
track

string

Identificador da faixa.

As faixas de formato têm um prefixo especial como identificador, por exemplo, wear:production, automotive:production.

Mais sobre nomes de faixa
releases[]

object (Release)

Em uma solicitação de leitura, representa todas as versões ativas na faixa. Em uma solicitação de atualização, representa as mudanças pretendidas.

Versão

Uma versão em uma faixa.

Representação JSON 
{
  "name": string,
  "versionCodes": [
    string
  ],
  "releaseNotes": [
    {
      object (LocalizedText)
    }
  ],
  "status": enum (Status),
  "userFraction": number,
  "countryTargeting": {
    object (CountryTargeting)
  },
  "inAppUpdatePriority": integer
}
Campos
name

string

O nome da versão. Não precisa ser único. Caso não seja definido, o nome é gerado com base no "versionName" do APK. Se a versão tiver vários APKs, o nome será gerado com base na data.
versionCodes[]

string (int64 format)

Códigos de versão de todos os APKs na versão. Obrigatório para reter das versões anteriores.
releaseNotes[]

object (LocalizedText)

Uma descrição das novidades desta versão.
status

enum (Status)

É o status do lançamento.
userFraction

number

Fração de usuários qualificados para uma versão gradual. 0 < fração < 1. Só pode ser definido quando o status for "inProgress" ou "halted".
countryTargeting

object (CountryTargeting)

Restringe uma versão a um grupo específico de países. Isso só pode ser definido para versões "inProgress" na faixa de produção.
inAppUpdatePriority

integer

Prioridade da atualização no app da versão. Todos os APKs recém-adicionados na versão terão essa prioridade. Os valores podem variar de 0 a 5, com 5 sendo a prioridade máxima. O padrão é 0. "inAppUpdatePriority" não pode ser atualizado depois que a versão for lançada. Acesse https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Texto localizado em determinado idioma.

Representação JSON 
{
  "language": string,
  "text": string
}
Campos
language

string

Código de localização do idioma: uma tag BCP-47, por exemplo, "de-AT" para alemão austríaco.
text

string

O texto no idioma determinado.

Status

O status de uma versão.

Tipos enumerados
statusUnspecified Status não especificado.
draft Os APKs da versão não estão sendo veiculados aos usuários.
inProgress Os APKs da versão estão sendo veiculados a uma fração dos usuários, determinada por "userFraction".
halted Os APKs da versão não serão mais veiculados aos usuários. Usuários que já têm esses APKs não são afetados.
completed A versão não terá mais mudanças. Seus APKs estão sendo veiculados a todos os usuários, a não ser que eles estejam qualificados para APKs de uma versão mais recente.

CountryTargeting

Especificação da segmentação por país.

Representação JSON 
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
Campos
countries[]

string

Países que serão segmentados, especificados como códigos CLDR de duas letras.
includeRestOfWorld

boolean

Incluir "resto do mundo" e países segmentados explicitamente.

Métodos

create

 Cria uma nova faixa.

get

 Recebe uma faixa.

list

 Lista todas as faixas.

patch

 Adiciona patches a uma faixa.

update

 Atualiza uma faixa.

Códigos de erro

As operações desse recurso retornam os seguintes códigos de erro HTTP:

Código do erro Motivo Descrição Resolução
400 invalidValue Um valor inválido foi fornecido na solicitação. Geralmente, isso é retornado para um token de compra malformado ou inválido. Corrija o valor do campo inválido no corpo ou nos parâmetros da solicitação com base na referência da API.
400 required Um campo ou parâmetro obrigatório está faltando na solicitação. Consulte a documentação da API para garantir que todos os campos e parâmetros obrigatórios estejam incluídos.
403 userInsufficientPermission O usuário não tem permissão suficiente para realizar a operação solicitada. Confira se o usuário autenticado tem as permissões necessárias no Google Play Console. Consulte Como usar uma conta de serviço para mais detalhes.
404 notFound Não foi possível encontrar o recurso solicitado. Verifique se os identificadores (por exemplo, token de compra, nome do pacote, ID do produto, ID da assinatura) estão corretos.
409 concurrentUpdate Houve uma tentativa de atualizar um objeto que está sendo atualizado simultaneamente. Tente de novo com uma espera exponencial. Evite modificações simultâneas no mesmo recurso.
5xx Generic error Erro genérico no servidor do Google Play. Tente fazer a solicitação novamente.

Se o problema persistir, entre em contato com seu gerente de contas do Google Play ou envie uma solicitação de suporte. Confira o Painel de status do Google Play para saber se há falhas conhecidas.