Objeto de datos de frecuencia: administración de campañas
Determina si un trabajo de importación debe ejecutarse una vez o programarse periódicamente.
Puede programar una importación periódica, por ejemplo, "Todos los domingos a las 4:00 p.m." o puede ejecutar la importación una vez.
- Automático: Microsoft Advertising ejecutará las importaciones según una programación diferente que optimizará mejor las campañas.
- Ahora: importe una vez en cuanto llame a la operación AddImportJobs .
- Una vez: importe una vez en el momento especificado.
- Diario: importe una vez al día en el momento que especifique.
- Semanal: importe una vez por semana en el momento que especifique.
- Mensual: importe una vez al mes en el momento que especifique.
Para ejecutar la importación "now", puede dejar el elemento Frequency del trabajo de importación de Google nil o vacío. Para todas las demás opciones de programación, establezca los valores de frecuencia Tipo y Cron . Para obtener más información sobre los valores de frecuencia admitidos , consulte los comentarios siguientes.
<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
El objeto Frequency tiene los siguientes elementos: Cron, TimeZone, Type.
Elemento | Descripción | Tipo de datos |
---|---|---|
Cron | Representa una implementación simplificada de la frecuencia Cron. Por ejemplo, establezca la cadena en "0 16 * * 3 *" si desea que la importación se ejecute semanalmente, todos los miércoles a las 16:00. Para obtener más información sobre los valores de frecuencia admitidos, consulte los comentarios. Agregar: Obligatorio si type se establece en "Scheduling" y, en caso contrario, se omite el valor cron. |
string |
Zona horaria | Zona horaria utilizada para la programación de importación. Para ver los valores posibles, consulte Zonas horarias. Agregar: Opcional. Si no establece este elemento, se usará "GreenwichMeanTimeDublinEdinburghLisbonLondon" (UTC+0) de forma predeterminada. |
string |
Tipo | Tipo de frecuencia de programación. Establezca este elemento en "Programación" si desea elegir un valor Cron específico, si el trabajo de importación debe ejecutarse una vez o de forma periódica. Establezca este elemento en "Auto" si quiere que Microsoft Advertising ejecute importaciones según una programación diferente que optimice mejor las campañas. Si desea que la importación se ejecute ahora, puede establecer este elemento en "RunNow" o no establecer el elemento Frequency del trabajo de importación de Google. Agregar: Obligatorio |
string |
Comentarios
Las importaciones programadas admiten una implementación simplificada de Cron con hasta 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)
Estos son algunos ejemplos válidos.
Cadena Cron | Frecuencia de importación |
---|---|
"0 2 15 09 * 2020" | Ejecute una vez el 15 de septiembre de 2020 a las 2:00 a.m. |
"0 16 * * * *" | Ejecutar todos los días a las 4:00 p.m. |
"0 16 * * 3 *" | Ejecutar semanalmente, todos los miércoles a las 4:00 p.m. |
"0 16 1 * * *" | Ejecutar mensualmente, el primer día de cada mes a las 4:00 p.m. |
Requisitos
Servicio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13