Registo de Grupo de Recursos a Listar Registo de Grupo - Em Massa

Define um grupo de recursos que pode ser carregado e transferido num ficheiro em massa.

Pode carregar registos do Grupo de Recursos que listem registos de grupos para vários grupos de anúncios no mesmo ficheiro em massa, desde que as regras de validação sejam cumpridas, conforme descrito abaixo.

• No mínimo, tem de especificar, pelo menos, o nó raiz para a estrutura da árvore do grupo de partições do produto. O nó raiz do grupo de partições de produtos tem de ter o campo Condição de Produto 1 definido como "Tudo" e Valor do Produto 1 nulo ou vazio. Se estiver a licitar em todos os produtos no catálogo de forma igual, defina o campo Sub type como Unidade. Se estiver a criar partições das ofertas com base em condições de produto mais específicas, defina o campo Sub type como Subdivisão, o ID do Critério Principal como nulo ou vazio e o ID para um valor negativo. Irá utilizar o valor negativo como ID de Critério Principal para todos os nós subordinados.

• O nó raiz é considerado nível 0 e uma árvore pode ter ramos até 7 níveis de profundidade.

• Por pedido de carregamento, pode incluir um máximo de 20 000 nós de árvore de partição de produtos por grupo de anúncios. A contagem completa de nós da árvore de partições do produto para um grupo de anúncios não pode exceder os 20 000.

• Os nós da árvore de partição do produto para a mesma árvore (mesmo grupo de anúncios) têm de ser agrupados no ficheiro.

• A ordem dos nós de partição do produto não é garantida durante a transferência e os nós principais podem ser fornecidos após os nós subordinados; no entanto, todos os nós do mesmo grupo de anúncios serão agrupados no ficheiro.

• Se estiver a criar ou modificar a estrutura da árvore, os nós da árvore de partição do produto principal têm de ser ordenados antes dos nós da árvore de partição do produto subordinado; no entanto, a ordem não importa para alterações não estruturais, tais como a actualização da oferta. Por exemplo, se quiser atualizar as ofertas sem adicionar, eliminar ou atualizar a estrutura da árvore, só precisa de carregar os campos ID, ID Principal e Licitação .

• Para atualizar o campo Condição do Produto 1, Valor do Produto 1 ou Está Excluído , tem de eliminar o nó de árvore de partição de produto existente e carregar um novo nó de árvore de partição de produto que irá obter um novo identificador.

• Se alguma ação falhar, todas as ações restantes que possam ter sido bem-sucedidas também falharão.

• Todas as ações de adição e eliminação de nós de partição de produtos têm de resultar numa estrutura de árvore completa.

• Todos os caminhos do nó raiz até ao fim de um ramo têm de terminar com um nó de folha (Sub Type=Unit). Cada Unidade tem de ter uma oferta, a menos que o campo É Excluído seja VERDADEIRO, o que significa que o nó é um critério de grupo de anúncios negativo.

• Cada subdivisão deve ter, pelo menos, um nó de folha que lance no resto das condições da subdivisão, ou seja, utilizar o mesmo operando que as unidades colaterais e definir o valor do produto 1 nulo ou vazio.

• Se estiver a adicionar partições com vários níveis em que o elemento principal ou o subordinado ainda não existem, utilize um valor int negativo como referência para identificar o elemento principal. Por exemplo, defina o ID do elemento principal e o campo ID do Critério Principal do menor para o mesmo valor negativo. Os IDs negativos só são válidos durante a chamada. Os identificadores de sistema exclusivos para cada critério de grupo de anúncios adicionado com êxito são devolvidos no ficheiro de resultado de carregamento.

• Para colocar em pausa qualquer partição de produto, tem de colocar todo o grupo de anúncios em pausa ao atualizar o campo Estado do Grupo de Anúncios para Colocado em Pausa. Pode colocar toda a campanha em pausa ao atualizar o campo Estado da Campanha para Em Pausa.

• Para uma ação Eliminada , só precisa de especificar o ID e o ID Principal.

• Se eliminar uma partição de produto principal, todos os respetivos subordinados e descendentes também serão eliminados.

• Não pode especificar condições de produto duplicadas num ramo.

Pode transferir todos os registos do Grupo de Recursos na conta ao incluir o valor DownloadEntity de AssetGroupListingGroups no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkAssetGroupListingGroup , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

Para um registo grupo de recursos que lista o grupo , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

• Grupo de Recursos
• Campanha
• ID de Cliente
• ID
• Está Excluído
• Hora da Modificação
• ID principal
• ID do Grupo de Listagem Principal
• Condição do Produto 1
• Valor do Produto 1
• Estado
• Subtipo

Grupo de Recursos

O nome do grupo de recursos ao qual pertence o grupo de listagem de grupos de ativos.

Para adicionar, atualizar e eliminar, tem de especificar o ID Principal ou o campo Grupo de Ativos e Campanha .

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Campanha

O nome da campanha que contém o grupo de recursos e o grupo de listagem.

Para adicionar, atualizar e eliminar, tem de especificar o ID Principal ou o campo Grupo de Ativos e Campanha .

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do grupo de recursos que lista o grupo.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificadores negativos para o grupo de listagem de grupos de ativos pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como anúncios, palavras-chave ou critério. Isto é recomendado se estiver a adicionar novos grupos de recursos que listam grupos e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Está Excluído

Determina se os produtos pertencem ao grupo de lista devem ser excluídos ao servir.

Se definido como verdadeiro , é um critério negativo e, caso contrário, se for falso , é um critério positivo.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID principal

O ID do grupo de recursos que contém o grupo de listagem.

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Ativos e Campanha .

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

ID do Grupo de Listagem Principal

No mínimo, tem de especificar, pelo menos, o nó raiz da estrutura da árvore.

O nó raiz do grupo de listagem tem de ter o campo Condição de Produto 1 definido como Tudo e Valor do Produto 1 nulo ou vazio.

Se estiver a licitar em todos os produtos no catálogo de forma igual, defina o campo Sub type como Unidade.

Se estiver a criar partições dos produtos com base em condições de produto mais específicas, defina o campo Sub type como Subdivisão, o ID do Grupo de Listagem Principal como nulo ou vazio e o ID para um valor negativo. Irá utilizar o valor negativo como ID do Grupo de Listagem Principal para todos os nós subordinados.

Adicionar: Necessário
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Condição do Produto 1

O operando da condição. Os operandos incluem implicitamente o operador de igual. Por exemplo, pode ler Marca como Marca=.

Utilize a Condição de Produto 1 como operando do Valor do Produto 1.

Podem ser especificadas várias condições de produto para cada grupo de recursos Do Microsoft Performance Max. Cada condição é cumprida se o valor do atributo do produto for igual ao valor do atributo do operando. Por exemplo, se operando estiver definido como Marca e o atributo estiver definido como Contoso, a condição será cumprida se o valor do atributo Marca do catálogo de produtos for igual a Contoso.

Nas campanhas Performance Max, as condições do produto só podem ser definidas ao nível do grupo de recursos. A tabela seguinte descreve as regras de negócio da Condição do Produto (operando) e do Valor do Produto (atributo) para objetos do grupo de ativos AssetGroupListingGroup .

Condição do Produto (Operando)	Descrição do Valor do Produto (Atributo)	Regras de Partição de Produtos do Grupo de Ativos
Todos	Tem de ser nulo.	Para as partições de produtos de um grupo de recursos, o nó raiz tem de ter o operando definido como Tudo e atributo definido como nulo ou vazio.
Marca	Fabricante, marca ou fabricante do produto. Um máximo de 1000 carateres.	Para as partições de produtos de um grupo de recursos, o nó raiz tem de ter o operando definido como Tudo e atributo definido como nulo ou vazio.
CategoriaL1-5 Estão disponíveis cinco valores de operando de categoria, ou seja, CategoryL1, CategoryL2, CategoryL3, CategoryL4 e CategoryL5.	Uma categoria de produto definida pela loja Microsoft Merchant Center. Veja Taxonomia da Categoria Bing para obter valores de categoria válidos e taxonomia. CategoryL0 é a categoria de nível mais alto e CategoryL4 é o nível mais baixo ou a categoria mais granular. Um máximo de 100 carateres.	Cada um dos operandos CategoryL pode ser utilizado em vários ramos. Cada um dos operandos CategoryL pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter CategoryL1 e CategoryL2, mas pode não conter outro nó com o operando CategoryL2 . Se definir o operando para uma categoria de produto de 1 a 5, estes têm de ser especificados por ordem ascendente. Por exemplo, o operando pode ser definido como CategoryL2 com o atributo Pet Supplies, se uma partição de produto de nível superior tiver o operando CategoryL1 com o atributo Animals & Pet Supplies. O operando de categoria de produto de nível anterior não precisa de ser especificado na partição principal imediata. Por exemplo, uma condição CategoryL2 poderia ser especificada para uma partição de produto se o elemento principal do respetivo principal especificasse uma condição CategoryL1 .
Canal	O canal Anúncios de Inventário Local (LIA). Os valores possíveis incluem "Lojas Locais" e "Online". Se a campanha não tiver optado pelos Anúncios de Inventário Local, todas as ofertas são, por predefinição, Apenas Online (Channel=Online) e Canal Único (ChannelExclusivity=Single-channel). Para obter mais informações, veja a página de ajuda Anúncios de Inventário Local .	O operando Canal pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
ChannelExclusivity	Exclusividade do canal de Anúncios de Inventário Local (LIA). Os valores possíveis incluem "Canal único" e "Multi-channel". Se a campanha não tiver optado pelos Anúncios de Inventário Local, todas as ofertas são, por predefinição, Apenas Online (Channel=Online) e Canal Único (ChannelExclusivity=Single-channel). Para obter mais informações, veja a página de ajuda Anúncios de Inventário Local .	O operando ChannelExclusivity pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
Condição	A condição do produto. Se operando estiver definido como Condição, os valores de atributo suportados que pode especificar são Novo, Utilizado e Recondicionado.	O operando Condição pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
CustomLabel0-4 Estão disponíveis cinco valores de operando de etiqueta personalizada, ou seja, CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 e CustomLabel4.	Uma etiqueta personalizada definida pelo comerciante. As etiquetas personalizadas, por exemplo, CustomLabel0 e CustomLabel4 não são validadas com base em nenhuma hierarquia. Um máximo de 100 carateres.	Cada um dos operandos CustomLabel pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter CustomLabel0 e CustomLabel1, mas pode não conter outro nó com o operando CustomLabel1 .
ID	O identificador do produto definido pelo comerciante. Um máximo de 1000 carateres.	O operando ID pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
ProductType1-5 Estão disponíveis cinco valores de operando de tipo de produto, ou seja, ProductType1, ProductType2, ProductType3, ProductType4 e ProductType5.	Um tipo de produto ou categoria definido pelo comerciante. ProductType1 é o tipo de produto de nível mais alto e ProductType5 é o tipo de produto mais baixo ou granular. Um máximo de 100 carateres.	Cada um dos operandos ProductType pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter ProductType1 e ProductType2, mas pode não conter outro nó com o operando ProductType2 . Se definir o operando para um tipo de produto de 1 a 5, estes têm de ser especificados por ordem ascendente. Por exemplo, o operando pode ser definido como ProductType2 com o atributo Pet Supplies, se uma partição de produto de nível superior tiver o operando ProductType1 com o atributo Animals & Pet Supplies. O operando de tipo de produto de nível anterior não precisa de ser especificado na partição principal imediata. Por exemplo, uma condição ProductType2 poderia ser especificada para uma partição de produto se o principal do respetivo elemento principal especificasse uma condição ProductType1 .

Adicionar: Necessário
Atualização: Só de leitura. Não é possível atualizar os campos de condição ou valor. Para atualizar as condições, tem de eliminar a partição do produto e adicionar uma nova.
Eliminar: Só de leitura

Valor do Produto 1

O valor do atributo da condição.

O valor de um atributo tem de corresponder exatamente ao valor especificado no ficheiro de catálogo do Microsoft Merchant Center do cliente.

Adicionar: Necessário
Atualização: Só de leitura. Não é possível atualizar os campos de condição ou valor. Para atualizar as condições, tem de eliminar a partição do produto e adicionar uma nova.
Eliminar: Só de leitura

Estado

O estado do grupo de recursos que lista o grupo.

Os valores possíveis são Ativo, Eliminado.

Adicionar: Opcional.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Subtipo

O tipo de grupo de recursos que lista o grupo.

Os valores possíveis são Subdivisão e Unidade.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura