Outros casos de uso

Qualificação

O GTAF PODE emitir a seguinte solicitação de qualificação para verificar se um usuário está qualificado para comprar um plano.

GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}

planId é o identificador exclusivo do plano que pode ser usado para comprar o plano em nome do usuário (consulte Compra de dados). Se planId não for especificado, a DPA PRECISA retornar todos os planos que podem ser adquiridos por esse usuário.

Casos de erros lista as respostas esperadas da DPA em caso de um erro. Além disso, a DPA SHALL retornará um erro nos seguintes casos de erro:

• A DPA retorna um código de erro 400 BAD REQUEST indicando ao GTAF que planId é inválido.
• A DPA retorna um código de erro 409 CONFLICT indicando que planId é incompatível com o plano de dados do usuário.

Caso contrário, a DPA SHAW retornará uma resposta 200-OK. O formato de uma EligibleResponse bem-sucedida é:

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

Quando a solicitação inclui um planId, a resposta inclui apenas esse plano. Caso contrário, a lista incluirá todos os planos que o usuário está qualificado para comprar. Se planId estiver vazio e a DPA não for compatível com o retorno da lista de planos qualificados, PRECISA retornar um erro 400 BAD REQUEST.

Experiências do Android 5G

O GTAF permite que as operadoras compartilhem o status de limitação por tipo de conexão para os assinantes. As informações podem ser extraídas periodicamente pela GTAF, ou as operadoras podem fazer o envio delas com base em gatilhos internos.

API Pull

O dispositivo pode extrair as informações de medição pela GTAF usando o seguinte:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

O DPA (agente de plano de dados) representa um servidor GW de API ou de direitos na rede da operadora.

userKey é o token de autenticação estabelecido durante a fase de autenticação inicial, conforme definido aqui.

client_id é o AndroidSystemInfo

O status de Limitação é fornecido como um ENUM

A DPA retornará 200 respostas OK e incluirá planInfoPerClient. O tratamento de erros para DPA é definido aqui.

No modelo pull, a GTAF atua como um cliente e valida o certificado SSL da DPA. O GTAF se autentica na DPA usando o procedimento OAuth definido aqui.

API Push

A operadora também pode enviar as informações de medição usando os seguintes recursos com base em um evento de acionamento, como alteração do plano de preços etc.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

A DPA vai incluir planInfoPerClient no corpo da mensagem. As respostas de erro da GTAF são definidas aqui

No modo push, o GTAF autentica solicitações de entrada da DPA usando o servidor OAuth2 do Google Cloud. As solicitações recebidas precisam ser autenticadas com uma conta de serviço que esteja na lista de permissões do Portal ISP para o ASN que a DPA representa. Consulte este guia para ver mais detalhes.