REST Resource: edits.tracks

Risorsa: Traccia

Una configurazione del canale. La risorsa per TracksService.

Rappresentazione JSON 
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
Campi
track

string

Identificatore della traccia.

Le tracce del fattore di forma hanno un prefisso speciale come identificatore, ad esempio wear:production, automotive:production.

Scopri di più sul nome della traccia
releases[]

object (Release)

In una richiesta di lettura, rappresenta tutte le release attive nella traccia. In una richiesta di aggiornamento, rappresenta le modifiche desiderate.

Rilascia

Una release all'interno di un percorso.

Rappresentazione JSON 
{
  "name": string,
  "versionCodes": [
    string
  ],
  "releaseNotes": [
    {
      object (LocalizedText)
    }
  ],
  "status": enum (Status),
  "userFraction": number,
  "countryTargeting": {
    object (CountryTargeting)
  },
  "inAppUpdatePriority": integer
}
Campi
name

string

Il nome della release. Non è necessario che sia univoco. Se non è impostato, il nome viene generato da versionName dell'APK. Se la release contiene più APK, il nome viene generato dalla data.
versionCodes[]

string (int64 format)

I codici versione di tutti gli APK nella release. Devono includere i codici versione da conservare delle release precedenti.
releaseNotes[]

object (LocalizedText)

Una descrizione delle novità di questa release.
status

enum (Status)

Lo stato dell'uscita.
userFraction

number

Frazione di utenti idonei a una release scaglionata. 0 < frazione < 1. Può essere impostato solo quando lo stato è "inProgress" o "halted".
countryTargeting

object (CountryTargeting)

Limita una release a un insieme specifico di paesi. Tieni presente che questa operazione è consentita solo per le release in corso nel canale di produzione.
inAppUpdatePriority

integer

Priorità dell'aggiornamento in-app della release. Tutti gli APK appena aggiunti nella release verranno presi in considerazione con questa priorità. Può assumere valori compresi nell'intervallo [0, 5], dove 5 è la priorità più alta. Il valore predefinito è 0. inAppUpdatePriority non può essere aggiornato una volta implementata la release. Consulta https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Testo localizzato nella lingua specificata.

Rappresentazione JSON 
{
  "language": string,
  "text": string
}
Campi
language

string

Codice di localizzazione della lingua (un tag di lingua BCP-47; ad esempio, "de-AT" per il tedesco austriaco).
text

string

Il testo nella lingua specificata.

Stato

Lo stato di un'uscita.

Enum
statusUnspecified Stato non specificato.
draft Gli APK della release non vengono pubblicati per gli utenti.
inProgress Gli APK della release vengono pubblicati per una frazione di utenti, determinata da "userFraction".
halted Gli APK della release non verranno più mostrati agli utenti. Gli utenti che hanno già questi APK non sono interessati.
completed La release non subirà ulteriori modifiche. I suoi APK vengono pubblicati per tutti gli utenti, a meno che non siano idonei per gli APK di una release più recente.

CountryTargeting

Specifica del targeting per paese.

Rappresentazione JSON 
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
Campi
countries[]

string

Paesi da scegliere come target, specificati come codici CLDR di due lettere.
includeRestOfWorld

boolean

Includi "Resto del mondo" e i paesi target espliciti.

Metodi

create

 Crea una nuova traccia.

get

 Recupera una traccia.

list

 Elenca tutte le tracce.

patch

 Applica patch a una traccia.

update

 Aggiorna una traccia.

Codici di errore

Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:

Codice di errore Motivo Descrizione Risoluzione
400 invalidValue Nella richiesta è stato fornito un valore non valido. Questo errore viene spesso restituito per un token di acquisto non valido o con un formato non corretto. Correggi il valore del campo non valido nel corpo della richiesta o nei parametri in base al riferimento API.
400 required Nella richiesta manca un campo o un parametro obbligatorio. Consulta la documentazione dell'API per assicurarti di includere tutti i campi e i parametri obbligatori.
403 userInsufficientPermission L'utente non dispone di autorizzazioni sufficienti per eseguire l'operazione richiesta. Assicurati che l'utente autenticato disponga delle autorizzazioni necessarie in Google Play Console. Per ulteriori dettagli, consulta Utilizzo di un service account.
404 notFound Impossibile trovare la risorsa richiesta. Verifica che gli identificatori (ad es. token di acquisto, nome del pacchetto, ID prodotto, ID abbonamento) siano corretti.
409 concurrentUpdate È stato effettuato un tentativo di aggiornamento di un oggetto in fase di aggiornamento simultaneo. Riprova a inviare la richiesta con il backoff esponenziale. Evita modifiche simultanee alla stessa risorsa.
5xx Generic error Errore generico nel server Google Play. Riprova a inviare la richiesta.

Se il problema persiste, contatta il tuo Account Manager Google Play o invia una richiesta di assistenza. Ti consigliamo di controllare la dashboard dello stato di Play per eventuali interruzioni note.