O que faz o botão «Run Query» do Temu Connector for Odoo

Quando aparece e quem lá chega

O botão Run Query está no ecrã Research Queries. A condição da vista não o oculta: no Odoo 17, 18 e 19 vê-se sempre. O que limita é o caminho até ao ecrã: as fichas abrem-se a partir do menu Temu › Market Intelligence › Market Research, e os troços Market Intelligence e Market Research exigem a permissão Temu Research & DSA. Se não a tiver, não vê esse troço do menu.

Com o Odoo em português, o botão continua a chamar-se Run Query, porque o módulo não o traduz.

Um caso para o ver a funcionar

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Casa Alba Textil é uma loja inventada que vende no Temu e quer consultar a biblioteca de anúncios. A Marta, que trata do comércio eletrónico e tem a permissão Temu Research & DSA, entra em Temu › Market Intelligence › Market Research e abre uma consulta em Research Queries. No grupo Ads Library Params deixa Ads Query Type em Product Name e prime Run Query.

Primeira tentativa: o Odoo mostra-lhe Research & DSA UI is currently disabled for this Odoo database. Enable it from the Temu instance before using this option. É a primeira coisa que o botão verifica, antes de tocar na consulta, pelo que a execução pára e não se guarda nada.

Segunda tentativa: com a função já ativada a partir da instância, a Marta prime outra vez. Agora o botão avança, pede os dados ao Temu e, ao terminar, a consulta fica como realizada.

O que faz o botão, por ordem

1. Verifica que a função de investigação está ativada na instância do Temu da consulta. Se não estiver, pára com a mensagem do caso.
2. Verifica o modo de acesso da consulta: esta operação usa a API do Temu e só admite o acesso público de investigação do artigo 40(12).
3. Conforme o tipo de consulta, exige alguns dados: para SOR, as datas de início e de fim do pedido; para informação da loja e para produtos da loja, o nome da loja e o código do país; para opiniões de produto, esses dois e o identificador do produto. A consulta de biblioteca de anúncios não pede nenhum destes.
4. Pede os dados ao Temu e extrai as linhas da resposta.
5. Se tudo correu bem, marca a consulta como realizada e guarda o resultado (secção seguinte).

O que muda ao terminar

Quando a consulta termina bem, o botão deixa-a como realizada e guarda o método utilizado com os parâmetros enviados, a resposta do Temu, o número de resultados e a data e hora da última execução. Apaga também o texto de erro anterior. O número de resultados é o de linhas da resposta; nos tipos que não são biblioteca de anúncios, se não há lista de linhas mas a resposta traz conteúdo, conta um.

Se algo falhar dentro da consulta, o botão deixa-a em estado de erro, guarda o texto do erro e a data da última execução, e volta a lançar o erro para que o veja.

Biblioteca de anúncios: várias páginas com um clique

Este tipo de consulta tem o seu próprio percurso. Entre os seus parâmetros, na ficha de Research Queries, grupo Ads Library Params, estão estes:

• Ads Query Type, com os valores Product Name, Advertiser e Ad Payer; por defeito o código usa Product Name.
• Category.
• Ad Publish Start Ts, cuja ajuda diz: «Milliseconds timestamp for ads library start filter.».
• Ad Publish End Ts, cuja ajuda diz: «Milliseconds timestamp for ads library end filter.».

Ao executar, se a consulta não trouxer identificadores de lista e de pesquisa, o botão gera-os e guarda-os nela. Se o idioma estiver vazio, usa inglês; o número de página mínimo é um; o tamanho de página é vinte se não for indicado e nunca passa de cinquenta.

Se a consulta estiver marcada para trazer todas as páginas, o botão repete o pedido página a página; se não, fica na primeira. Pára ao chegar ao máximo de páginas da instância (vinte se não tiver valor), ao receber uma página vazia, ao atingir o total que o Temu informa, quando a resposta indica que não há mais páginas ou, se não indicar nada, quando chega uma página com menos linhas do que o tamanho de página. No fim guarda um resumo com as páginas pedidas, o motivo de paragem, o total de linhas reunidas e os métodos utilizados.

O que tirar do caso

• A mensagem de investigação desativada não fala da sua consulta: surge antes de rever o que quer que seja nela e não altera nada.
• O botão não se oculta (no Odoo 17, 18 e 19); o que decide se lá chega é a permissão Temu Research & DSA.
• Antes de premir numa consulta de biblioteca de anúncios, reveja os campos do grupo Ads Library Params, entre eles Ads Query Type, Category e os dois de marca temporal, porque delimitam o que se pede.
• Para lançar a consulta de novo basta voltar a premir o botão; cada execução bem-sucedida sobrescreve o resultado guardado e apaga o erro anterior.

Como ajuda a FlexigoTech

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser ver o módulo, está na sua página em flexigotech.com.

Continue a ler

Verificado no código do conector (versão 19.0) e nas fontes indicadas

Fontes

• Código do módulo: flexigobe_temu_connector 19.0 (455b3f0f): views/temu_ads_views.xml
• Código do módulo: flexigobe_temu_connector 19.0 (455b3f0f): models/temu_ads.py
• flexigotech.com/en/services.html