Objeto de Dados de Frequência - Gestão de Campanhas
Determina se uma tarefa de importação deve ser executada uma vez ou agendada de forma periódica.
Pode agendar uma importação periódica, por exemplo, "Todos os domingos às 16:00" ou pode executar a importação uma vez.
- Automático: o Microsoft Advertising executará importações com base numa agenda variada que melhor otimizará as suas campanhas.
- Agora: importe assim que chamar a operação AddImportJobs .
- Uma vez: importe uma vez no momento que especificar.
- Diariamente: importe uma vez por dia no momento especificado.
- Semanalmente: importe uma vez por semana no momento especificado.
- Mensalmente: importe uma vez por mês no momento especificado.
Para executar a importação "agora", pode deixar o elemento Frequência da tarefa de importação da Google nulo ou vazio. Para todas as outras opções de agendamento, defina os valores frequency Type e Cron . Para obter detalhes sobre os valores de frequência suportados, veja as Observações abaixo.
Sintaxe
<xs:complexType name="Frequency" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Cron" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
Elementos
O objeto Frequency tem os seguintes elementos: Cron, TimeZone, Type.
| Elemento | Descrição | Tipo de Dados |
|---|---|---|
| Cron | Representa uma implementação simplificada da frequência Cron. Por exemplo, defina a cadeia como "0 16 * * 3 *" se quiser que a importação seja executada semanalmente, todas as quartas-feiras às 16:00. Para obter detalhes sobre os valores de frequência suportados, veja Observações. Adicionar: Necessário se o Tipo estiver definido como "Agendamento" e, caso contrário, o valor cron for ignorado. |
cadeia |
| Fuso Horário | O fuso horário utilizado para a agenda de importação. Para valores possíveis, veja Fusos Horários. Adicionar: Opcional. Se não definir este elemento, será utilizado por predefinição "GreenwichMeanTimeDublinEdinburghLisbonLondon" (UTC+0). |
cadeia |
| Tipo | O tipo de frequência de agendamento. Defina este elemento como "Agendamento" se quiser escolher um valor Cron específico, se a tarefa de importação deve ser executada uma vez ou de forma periódica. Defina este elemento como "Automático" se pretender que o Microsoft Advertising execute importações com base numa agenda variada que melhor otimizará as suas campanhas. Se quiser que a importação seja executada agora, pode definir este elemento como "RunNow" ou não definir o elemento Frequência da tarefa de importação da Google. Adicionar: Necessário |
cadeia |
Observações
As importações agendadas suportam uma implementação simplificada do Cron com até seis componentes ordenados.
* * * * * *
- - - - - -
| | | | | |
| | | | | +----- year (1 - 9999)
| | | | +----- day of week (0 - 6) (Sunday=0)
| | | +------- month (1 - 12)
| | +--------- day of month (1 - 31)
| +----------- hour (0 - 23)
+------------- min (0)
Eis alguns exemplos válidos.
| Cadeia cron | Frequência de importação |
|---|---|
| "0 2 15 09 * 2020" | Executar uma vez no dia 15 de setembro de 2020 às 2:00 |
| "0 16 * * * *" | Executar diariamente às 16:00 |
| "0 16 * * 3 *" | Executar semanalmente, todas as quartas-feiras às 16:00 |
| "0 16 1 * * *" | Executar mensalmente, o 1º dia de cada mês às 16:00 |
Requisitos
Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13