Endpoints

Respostas de privacidade para as lojas

Respostas para o formulário Data safety do Google Play e o formulário App Privacy da App Store, lidas do código do app.

GEThttps://www.setherion.com/api/v1/projects/{id}/store/privacy

Plano: Qualquer plano

O formulário Data safety do Google Play e o formulário App Privacy da App Store são aqueles em que um primeiro app costuma travar. Eles perguntam sobre tipos de dados que o dono nunca escolheu pelo nome, como um ID de publicidade ou um registro de falhas. Esta chamada responde aos dois a partir do que o código do app faz: se as pessoas entram, o que é salvo, se fotos ou localização são usadas, se o projeto de celular mostra anúncios ou vende coisas e o que o Setherion acrescenta a um site publicado.

É gratuita e não usa créditos. Acesso de visualização é suficiente. As respostas são as mesmas que a janela “Publish to app stores” mostra nos passos dela. Veja Publicar nas lojas de apps.

São sugestões lidas do código, para o dono conferir antes de enviar. Não são aconselhamento jurídico. Quando um palpite é mais seguro de um lado, a resposta declara o dado em vez de deixá-lo de fora, porque uma loja perdoa uma linha a mais e remove um app por uma linha que falta.

Requisição

Aqui way é obrigatório, porque muda as respostas.

bash

curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/privacy?way=easy" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Parâmetro	Significado
`way`	Obrigatório. `easy` ou `native`. O caminho fácil envolve o site publicado, então as respostas dele incluem a contagem de visualizações de página, o ID aleatório de visitante e os relatórios de erro que o Setherion adiciona a todo site publicado. O caminho Native não faz isso, mas pode incluir anúncios e compras no app.

Resposta

json

{
  "ok": true,
  "way": "easy",
  "note": "Suggestions read from the app's code, for the owner to check before sending. Where a guess is safer one way, they declare rather than leave out.",
  "googlePlayDataSafety": "Google Play: Data safety\n\nDoes your app collect or share any of the required user data types?\n  Yes\nIs all of the user data collected by your app encrypted in transit?\n  Yes. Everything goes over HTTPS.\n\nData types:\n- App activity > App interactions: collected, not shared, required. Purposes: Analytics.\n  (Setherion counts the pages people open, under a random id kept in the app, for your visitor numbers.)\n- Device or other IDs > Device or other IDs: collected, not shared, required. Purposes: Analytics.\n  (That random id tells one visitor from another, nothing more.)\n- App info and performance > Crash logs: collected, not shared, required. Purposes: App functionality, Analytics.\n  (When the app hits an error, Setherion receives the error message, so you can fix it.)\n\nIf you connected Google Analytics to this app, it also collects app interactions and an id for Analytics.",
  "appStoreAppPrivacy": "App Store: App Privacy\n\nDo you or your third-party partners collect data from this app?\n  Yes, we collect data from this app\nIs any of it used to track people (across other companies' apps and websites)?\n  No\n\nData types:\n- Usage Data > Product Interaction: not linked to the user, not used for tracking. Purposes: Analytics.\n  (Setherion counts the pages people open, under a random id kept in the app, for your visitor numbers.)\n- Identifiers > Device ID: not linked to the user, not used for tracking. Purposes: Analytics.\n  (That random id tells one visitor from another, nothing more.)\n- Diagnostics > Crash Data: not linked to the user, not used for tracking. Purposes: App Functionality, Analytics.\n  (When the app hits an error, Setherion receives the error message, so you can fix it.)\n\nIf you connected Google Analytics to this app, it also collects app interactions and an id for Analytics."
}

Campo	Tipo	Significado
`way`	string	O caminho que você pediu.
`note`	string	O aviso acima, para mostrar ao lado das respostas.
`googlePlayDataSafety`	string	O formulário Data safety, como texto simples com quebras de linha (`\n`).
`appStoreAppPrivacy`	string	O formulário App Privacy, como texto simples com quebras de linha.

Cada texto começa com o nome do formulário, depois vêm as perguntas do formulário com a resposta embaixo de cada uma, depois Data types: com uma linha por tipo e o motivo entre parênteses embaixo dela, depois as eventuais observações. Imprima-o como está ou deixe-o ao lado do formulário enquanto você o preenche.

De onde as respostas são lidas

Login. Endereço de e-mail e ID de usuário são declarados quando as pessoas se cadastram no app. O formulário então também pergunta como as contas são criadas e se as pessoas podem pedir a exclusão dos seus dados. Se o app não tem um botão Delete account, a resposta diz para adicionar um primeiro, e a preparação para as lojas oferece a solicitação que o adiciona.
Dados salvos e IA. O que as pessoas digitam é declarado como conteúdo do usuário quando o app salva registros ou envia texto a um serviço de IA. Uma observação lembra o dono de declarar também nomes, telefones, endereços ou mensagens, se as pessoas os digitarem.
Fotos e vídeos. Quando o app tem um campo de arquivo para imagens ou vídeo, ou usa a câmera.
Localização. Quando o app pergunta ao celular onde ele está.
Compras. Quando o app recebe pagamentos pelo Stripe ou, no caminho Native, vende compras no app.
Anúncios (somente no caminho Native). O ID de publicidade, a localização aproximada e as interações com anúncios são declarados como compartilhados, e o rastreamento é respondido com Yes no formulário da App Store. Uma observação diz para comparar as linhas com a lista do próprio Google AdMob.
Site publicado (somente no caminho fácil). Visualizações de página, o ID aleatório de visitante e os registros de falhas. Uma observação diz que o Google Analytics, se conectado, coleta mais.

Os arquivos do próprio Setherion dentro do app ficam de fora, para não contarem como feitos pelo app.

Um app Native que não coleta nada recebe No na primeira pergunta de cada formulário e nenhum tipo de dado. Um app do caminho fácil sempre tem as entradas do site acima.

Erros

Status	Quando
`400`	`way` está ausente ou é algo diferente de `easy` ou `native`.
`401`	A chave está ausente, errada ou foi revogada.
`404`	Não existe esse app, ou a sua chave não consegue abri-lo.
`409`	O app ainda não tem código. Crie-o primeiro no Setherion.

As frases exatas

Status	`error`
`400`	`way is "easy" or "native".`
`404`	`No such app on this account.`
`409`	`This app has no code yet. Build it in Setherion first.`

Esta página foi útil?

Preparação para as lojas

Escrever a página da loja

Entre na comunidade

Perguntas, ideias e o que outras pessoas estão criando.