Importar e exportar listagens de repositórios

Em vez de inserir informações para suas listagens da Loja diretamente no Partner Center, você tem a opção de adicionar ou atualizar informações exportando suas listagens em um arquivo .csv, inserindo suas informações e ativos e importando o arquivo atualizado. Você pode usar esse método para criar listagens novas ou atualizar listagens já criadas.

Essa opção é especialmente útil se você deseja criar ou atualizar Listagens da Store para seu produto em vários idiomas, pois você pode copiar/colar as mesmas informações em vários campos e facilmente fazer as alterações que devem ser aplicada para idiomas específicos. No entanto, você não pode usar esse método para criar ou atualizar listagens da Store específicas da plataforma para aplicativos publicados anteriormente que dão suporte a versões mais antigas do sistema operacional.

Dica

Você também pode usar esse recurso para importar e exportar os detalhes da listagem da Store de um complemento. Para complementos, o processo funciona da mesma maneira exceto que somente os campos relevantes para complementos são incluídos. Tenha em mente que você sempre pode criar ou atualizar listagens diretamente no Partner Center (mesmo que tenha usado anteriormente o método de importação/exportação). Atualizar diretamente no Partner Center pode ser mais fácil quando você está apenas fazendo uma alteração simples, mas você pode usar qualquer método a qualquer momento.

Exportar listagens

Na página de visão geral do envio de um aplicativo, clique em Exportar listagem (na seção Listagens da loja) para gerar um arquivo .csv codificado em UTF-8. Salve esse arquivo em um local no seu computador.

Você pode usar o Microsoft Excel ou outro editor para editar o arquivo. Observe que as versões do Microsoft 365 do Excel permitirão que você salve um arquivo .csv como CSV UTF-8 (delimitado por vírgula) (*.csv), mas outras versões podem não dar suporte a isso. Você pode encontrar detalhes sobre quais versões do Excel oferecem suporte a esse recurso no Boletim de novos recursos do Excel 2016 e saber mais sobre como codificar UTF-8 em vários editores de codificação aqui.

Se você ainda não criou todas as listagem para seu produto, o arquivo .CSV exportado não conterá todos os dados personalizados. Você verá colunas para Campo, ID, Tipo e Padrão, além de linhas que correspondem a todos os itens que podem ser exibidos em um repositório de listagem.

Se você já criou listagens (ou se já tiver carregado pacotes), também é possível ver colunas identificadas com códigos de idioma-localidade que correspondem ao idioma para cada detalhe que você criou (ou que detectamos nos seus pacotes), bem como quaisquer informações de detalhes que você forneceu anteriormente.

Veja uma visão geral do que está contido em cada uma das colunas no arquivo .CSV exportado:

  • A coluna Campo contém um nome associado a cada parte de uma listagem da Store. Eles correspondem aos mesmos itens que você pode fornecer ao criar listagens da Store no Partner Center, embora alguns dos nomes sejam ligeiramente diferentes. Para itens que você pode inserir mais de um do mesmo tipo, é possível ver diversas linhas, até o número máximo que você pode fornecer. Por exemplo, para Recursos do aplicativo, você verá Recurso1, Recurso2 etc. até Recurso20 (desde que você possa fornecer até 20 recursos do aplicativo).
  • A coluna ID contém um número que o Partner Center associa a cada campo.
  • A coluna Tipo fornece diretrizes gerais sobre que tipo de informações fornecer para esse campo, como Caminho de Texto ou Relativo (ou URL para arquivo no Partner Center).
  • A coluna Padrão (e qualquer outra coluna identificada com códigos de idioma-localidade) representam o texto ou ativos associados a cada parte da listagem da loja. Você pode editar os campos nessas colunas para fazer atualizações em suas listagens da Store.

Importante

Não altere qualquer uma das informações nas colunas Campo, ID ou Tipo. As informações nessas colunas devem ser alteradas para que o arquivo importado seja processado.

Atualizar informações de listagem

Depois de exportar as listagens e salvar o arquivo .csv, você pode editar as informações de listagem diretamente no arquivo .csv.

Juntamente com a coluna padrão, cada idioma para o qual você criou uma listagem tem sua própria coluna. As alterações feitas em uma coluna serão aplicadas à sua descrição nesse idioma. Você pode criar listagens de novos idiomas ao adicionar o código de idioma-local na próxima coluna vazia na linha superior. Para obter uma lista de códigos de idioma-local válidos, consulte Idiomas suportados.

Você pode usar a coluna padrão para inserir informações que você deseja compartilhar em todas as descrições do aplicativo. Se o campo de determinado idioma for deixado em branco, as informações da coluna padrão serão usadas para esse idioma. Você pode substituir esse campo para um idioma específico ao inserir informações diferentes para esse idioma.

A maioria dos campos de listagem da Store é opcional. A Descrição e uma captura de tela são necessárias para cada detalhe; para idiomas sem pacotes associados, você também deverá fornecer um Título para indicar quais dos seus nomes de aplicativo reservado devem ser usados nessa lista. Para todos os outros campos, você pode deixar o campo vazio se você não quiser incluí-lo na listagem. Lembre-se de que se você deixar um campo para um idioma específico, analisaremos para ver se há informações nesse campo na coluna padrão. Em caso afirmativo, essas informações serão usadas.

Por exemplo, imagine o seguinte exemplo:

Exemplo de listagem exportado

  • O texto "Descrição padrão" será usado para o campo Descrição nas listagens em en-us e fr-fr. No entanto, o campo Descrição na listagem de es-es usaria o texto "Descrição em espanhol".
  • Para o campo Notas de versão, o texto "Notas de versão em inglês" serão usadas para en-us e o texto "Notas de versão em francês" será ser usado para fr-fr. Entretanto, nenhum notas de versão serão exibida para es-es.

Se você não quiser fazer quaisquer edições em um campo específico, você pode excluir a linha inteira da planilha, exceto as linhas de trailers, bem como miniaturas e títulos associados. Diferente para esses itens, excluir uma linha não afetará os dados associados a esse campo em suas listagens. Isso permite remover quaisquer linhas que você não pretende editar, portanto,é possível se concentrar nos campos em que está fazendo alterações.

A exclusão das informações em um campo para um idioma, sem remover a linha inteira, funciona de maneira diferente dependendo do campo. Para campos cujo Tipo é Texto, a exclusão das informações em um campo apenas remove essa entrada da listagem nesse idioma. No entanto, excluir as informações em um campo para uma imagem, como uma captura de tela ou logotipo, não terá nenhum efeito; a imagem anterior ainda será usada, a menos que você a remova editando diretamente no Partner Center. Excluir as informações de um campo de trailer realmente removerá esse trailer do Partner Center, portanto, certifique-se de que você tenha uma cópia de todos os arquivos necessários antes de fazê-lo.

Diversos campos em suas listagens exportadas exigem a entrada de texto, como aqueles no exemplo acima, Descrição e Notas de versão. Para esses tipos de campos, digite o texto apropriado no campo para cada idioma. Certifique-se de seguir o tamanho e outros requisitos de cada campo. Para saber mais sobre esses requisitos, consulte Criar listagens da Store do aplicativo.

O fornecimento de informações para os campos que correspondem aos ativos, como imagens e trailers, é um pouco mais complicado. Em vez de Texto, o Tipo para esses ativos é Caminho relativo (ou URL para arquivo no Partner Center).

Se você já tiver carregado ativos para a listagem da Store, esses ativos serão representados por uma URL. Essas URLs podem ser reutilizadas em várias descrições de um produto ou mesmo em produtos diferentes na mesma conta de desenvolvedor, portanto, você pode copiar essas URLs para reutilizá-las em um campo diferente, se desejar.

Dica

Para confirmar qual ativo corresponde a uma URL, é possível inserir a URL em um navegador para exibir a imagem (ou baixar o vídeo do trailer). Você deve estar conectado à sua conta do Partner Center para que essa URL funcione. Se você quiser usar um novo ativo que não adicionou anteriormente ao Partner Center, poderá fazer isso importando suas listagens como uma pasta, em vez de como um único arquivo .csv. É necessário criar uma pasta com o arquivo .csv. Em seguida, adicione as imagens à mesma pasta, na pasta raiz ou em uma subpasta. Você deverá inserir o caminho completo, incluindo o nome da pasta raiz, no campo.

Dica

Para obter os melhores resultados ao importar as listagens como uma pasta, certifique-se de usar a versão mais recente do Microsoft Edge, Chrome ou Firefox. Por exemplo, se a pasta raiz for my_folder e você quiser usar uma imagem chamada screenshot1.png para DesktopScreenshot1, é possível adicionar screenshot1.png na raiz da pasta e, em seguida, inserir my_folder/screenshot1.png no campo DesktopScreenshot1. Se você criou uma pasta de imagens na pasta raiz e, em seguida, inseriu screenshot1.jpg lá, é necessário inserir my_folder/images/screenshot1.png. Observe que depois de importar suas listagens usando uma pasta, os caminhos para suas imagens serão convertidos em URLs para os arquivos no Partner Center na próxima vez que você exportar suas listagens. É possível copiar e colar essas URLs para usá-las novamente (por exemplo, para usar os mesmos ativos em vários idiomas de listagem).

Importante

Se a listagem exportada incluir trailers, lembre-se de que excluir a URL para o trailer ou sua imagem em miniatura do arquivo .csv removerá completamente o arquivo excluído do Partner Center e você não poderá mais acessá-lo lá (a menos que ele também seja usado em outra listagem em que ele não tenha sido excluído).

Importar listagens

Depois de inserir todas as alterações no arquivo .csv (e incluir quaisquer ativos que você deseja carregar), é necessário salvar o arquivo antes de carregá-lo. Se você estiver usando uma versão do Microsoft Excel que dá suporte à codificação UTF-8, selecione Salvar como e use o formato UTF-8 (delimitado por vírgula) (*.csv). Se você usar um editor diferente para exibir e editar o arquivo .csv, verifique se que o arquivo está codificado em UTF-8 antes de carregar.

Quando você estiver pronto para carregar o arquivo .csv atualizado e importar seus dados de listagem, selecione Importar listagens na página de visão geral do envio. Se você estiver importando apenas um arquivo .csv, escolha Importar. csv, navegue até o arquivo e clique em Abrir. Se você estiver importando uma pasta com arquivos de imagem, escolha Importar pasta, navegue até a pasta e clique em Selecionar pasta. Verifique se há apenas um arquivo .csv na pasta, juntamente com quaisquer ativos que estiver carregando.

Conforme processamos o arquivo .csv importado, você verá uma barra de progresso que reflete o status de importação e validação. Isso pode demorar alguns minutos, especialmente se você tiver muitas listagens e/ou arquivos de imagem.

Em caso de problemas, você verá uma observação indicando que é necessário fazer as atualizações necessárias e tentar novamente. Selecione o link Exibir erros para verificar quais campos são inválidos e o motivo. Você precisa corrigir esses problemas no arquivo .csv (ou substituir qualquer ativo inválido) e, em seguida, importar suas listagens novamente.

Dica

É possível acessar essas informações novamente mais tarde por meio do link Exibir erros da última importação. Nenhuma das informações do arquivo .csv será salva no Partner Center até que todos os erros em seu arquivo tenham sido resolvidos, mesmo para campos sem erros. Depois de importar um arquivo .csv que não tenha erros, as informações de listagem fornecidas serão salvas no Partner Center e serão usadas para esse envio.

Você pode continuar a fazer atualizações em suas listagens importando outro arquivo de .csv atualizado ou fazendo alterações diretamente no Partner Center.

Complementos

Para complementos, importar e exportar listagens da Store usa o mesmo processo descrito acima, exceto que você verá apenas os três campos relevantes para listagens da Loja de complementos: Descrição, Título e StoreLogo300x300 (conhecido como Ícone na página de listagem da Loja no Partner Center). O campo Título é obrigatório e os outros dois campos são opcionais.

Observe que você deve importar e exportar listagens da Store separadamente para cada complemento em seu aplicativo, navegando até a página de visão geral de envio do complemento.

Em vez de inserir informações para a listagem da Loja diretamente no Partner Center, você tem a opção de adicionar ou atualizar informações exportando suas listagens em um arquivo .csv, inserindo suas informações e ativos e importando o arquivo atualizado. Você pode usar esse método para criar listagens novas ou atualizar listagens já criadas.

Essa opção é especialmente útil se você deseja criar ou atualizar Listagens da Store para seu produto em vários idiomas, pois você pode copiar/colar as mesmas informações em vários campos e facilmente fazer as alterações que devem ser aplicada para idiomas específicos.

Exportar listagem

Na página listagem da Store para um aplicativo, você pode adicionar idiomas e clicar em Exportar listagem para gerar um arquivo .csv com os idiomas selecionados e os campos para a listagem. Como alternativa, você pode primeiro clicar em Exportar listagem e, em seguida, selecionar os idiomas. Depois que a listagem for exportada com êxito, baixe a listagem. Na listagem exportada, você verá Nomes de campos, tipos e os idiomas selecionados para sua listagem.

Veja uma visão geral do que está contido em cada uma das colunas no arquivo .CSV exportado:

  • A coluna Campo contém um nome associado a cada parte de uma listagem da Store. Eles correspondem aos mesmos itens que você pode fornecer ao criar listagens da Store no Partner Center, embora alguns dos nomes sejam ligeiramente diferentes. Para itens em que você pode inserir mais de um dos mesmos tipos de itens, você verá várias linhas até o número máximo que você pode fornecer. Por exemplo, para recursos de produto, você verá ProductFeatures1, ProductFeatures2 etc., acessando ProductFeatures20 (já que você pode fornecer até 20 recursos de aplicativo). Consulte a tabela abaixo para localizar o mapeamento exato dos campos de listagem da Store com os campos exportados em .csv arquivo.
  • A coluna Tipo fornece diretrizes gerais sobre que tipo de informações fornecer para esse campo, como Texto ou Caminho relativo.
Nome do campo na listagem da Loja no Partner Center Nome do campo correspondente no arquivo de .csv exportado
DESCRIÇÃO Descrição
Nome do produto ProductName
O que há de novo nesta versão? WhatsNew
Recursos do produto ProductFeatures1 para ProductFeatures20
Capturas de tela Capturas de tela1 para Capturas de Tela10
Logotipos da loja (1:1 box art) StoreLogos1
Logotipos da loja (arte do pôster 2:3) StoreLogos2
Descrição breve Shortdescription
Hardware mínimo RequirementsMinimum1 to RequirementsMinimum11
Hardware recomendado RequirementsRecommended1 para RequirementsRecommended11
Termos de pesquisa SearchTerms1 para SearchTerms7
Informações sobre direitos autorais e marcas registradas Direitos autorais
Termos de licença aplicáveis Termos de licença aplicáveis
Desenvolvido por DevelopedBy

Importante

Não altere nenhum dos nomes de campo nem exclua nenhum dos campos no arquivo .csv exportado. O nome das colunas e itens no campo deve permanecer inalterado para que o arquivo importado seja processado.

Atualizar informações de listagem

Depois de exportar as listagens e salvar o arquivo .csv, você pode editar as informações de listagem diretamente no arquivo .csv. Para cada idioma adicionado, há uma coluna separada com o nome do idioma como o título. Não altere o nome do idioma exportado no arquivo .csv. As alterações feitas em uma coluna serão aplicadas à listagem desse idioma.

A maioria dos campos de listagem da Store é opcional. A descrição, uma captura de tela, o logotipo da Loja (1:1 box art) e os termos de licença aplicáveis são necessários para cada listagem. Para todos os outros campos, você pode deixar o campo vazio se você não quiser incluí-lo na listagem.

Muitos dos campos em suas listagens exportadas exigem entrada de texto, como os do exemplo acima, Descrição e WhatsNew. Para esses tipos de campos, digite o texto apropriado no campo para cada idioma. Certifique-se de seguir o tamanho e outros requisitos de cada campo. Para saber mais sobre esses requisitos, consulte Criar listagens da Store do aplicativo.

Fornecer informações para campos que correspondem a ativos, como imagens, é um pouco mais complicado. Em vez de Texto, o Tipo para esses ativos é Caminho relativo.

Dica

Se os ativos (captura de tela ou logotipo) estiverem na mesma pasta que o arquivo .csv exportado, o caminho relativo será apenas o nome da captura de tela ou logotipo (por exemplo: logo.png). Se você tiver criado uma subpasta para imagens na pasta main que tem o arquivo .csv, o caminho relativo começará com o nome da subpasta. (Por exemplo, se o nome da subpasta for "Imagens", o caminho relativo será Images/logo.png)

Listagem de importação

Depois de inserir todas as alterações no arquivo .csv (e incluir todos os ativos que deseja carregar), você precisará salvar o arquivo antes de carregá-lo.

Quando estiver pronto para carregar o arquivo de .csv atualizado e importar seus dados de listagem, selecione Importar listagem na página de listagem da Loja do aplicativo. Ao importar a listagem pela primeira vez, você precisará carregar a listagem usando uma pasta que terá o arquivo .csv exportado e todos os ativos. Verifique se há apenas um arquivo .csv na pasta, juntamente com quaisquer ativos que estiver carregando.

Importante

Ao importar a listagem pela primeira vez, você precisa carregar uma pasta. Essa pasta deve conter o arquivo de .csv exportado com as informações de listagem e todos os ativos (capturas de tela e logotipo) mencionados no arquivo .csv.

Se detectarmos problemas, você verá uma nota indicando que a Importação falhou. Baixe o relatório para marcar os erros. Você precisa corrigir esses problemas no arquivo .csv (ou substituir qualquer ativo inválido) e, em seguida, importar suas listagens novamente.

Consulte a tabela abaixo para obter as mensagens de erro, seu significado e a recomendação para resolve-las.

Mensagem de erro Significado e recomendação
"O arquivo .csv está vazio. Verifique se o arquivo tem as informações necessárias." Você pode ter carregado um arquivo de .csv em branco. Na página listagem da Store, exporte o arquivo de .csv mais recente.
"O campo não está presente ou inválido. Use o modelo correto exportando a listagem." Você pode ter excluído um campo existente ou adicionado um novo campo no arquivo de .csv exportado. Exporte o arquivo .csv da página de listagem da Loja. Não altere nenhum dos campos no arquivo .csv.
"Os códigos de idioma são inválidos ou a listagem não está disponível para os idiomas. Use o modelo mais recente exportando a listagem." Você pode ter editado o código de idioma no arquivo de .csv exportado ou pode ter adicionado um novo código de idioma que não está presente na página de listagem da Loja. Na página listagem da Loja, selecione os idiomas necessários e exporte a listagem.
"Todos os idiomas selecionados não estão presentes no arquivo .csv importado. Use o modelo mais recente exportando a listagem." Talvez você tenha removido um código de idioma no arquivo .csv. Exporte o arquivo de .csv da página de listagem da Loja. Não altere nenhum dos códigos de idioma no arquivo .csv.

Você pode continuar a fazer atualizações em suas listagens importando outro arquivo de .csv atualizado ou fazendo alterações diretamente no Partner Center.