Fusos horários, contas e faturamento
Valores datetime são sempre retornados em horário UTC (como indicado pelo Z no final do valor datetime). Datetimes podem ser especificados em qualquer fuso horário em um comando POST ou PUT usando o formato padrão ISO 8601 para fuso horário. O tempo é representado usando um subconjunto de ISO-8601. Mais especificamente, a string strptime para nosso formato de data é%Y-%m-%dT%l:%M:%S%z. O fuso horário da conta do anunciante determina o horário real em que os números oficiais de faturamento são congelados.
Ao consultar a API em nível de conta (GET accounts), você obterá informações de fuso horário como esta:
Exemplo de resposta
timezone (consulte fusos horários na wikipedia para uma visão geral) e timezone_switch_at. Note que timezone_switch_at é dado no fuso horário UTC (+00:00), mas sempre representará meia-noite no fuso horário fornecido.
O fuso horário do anunciante não é editável via API. Este atributo é definido em nível contratual/de faturamento pelo account manager do X do anunciante.
Esteja ciente do valor de timezone_switch_at ao criar relatórios e consultar nossos endpoints de analytics, pois haverá um intervalo no dia em que a conta muda do fuso horário America/Los_Angeles para o novo valor local.
Especificando valores Datetime com fuso horário
Valores datetime são sempre retornados em horário UTC (como indicado peloZ no final do valor datetime). Datetimes podem ser especificados em qualquer fuso horário em um comando POST ou PUT usando o formato padrão ISO 8601 para fuso horário. Por exemplo, 2017-07-10T08:00:00-0800 é um valor de entrada aceitável e será traduzido automaticamente para o valor UTC de 2017-07-10T16:00:00Z.
Ao usar os endpoints de analytics com granularity de DAY ou TOTAL, o valor de start_time deve ser especificado à meia-noite do dia desejado no fuso horário local do titular da conta. O offset de fuso horário a ser usado será o offset do dia atual, não o offset do dia em questão. Por exemplo, para uma conta ads em America/Los_Angeles durante o horário de verão do Pacífico, o offset UTC é -0700. Assim, em uma requisição de analytics, o horário deve ser especificado como: start_time=2017-05-21T07:00:00Z ou start_time=2017-05-21T00:00:00-0700. Se a conta ads estivesse em Asia/Tokyo, onde o offset é sempre +09:00, os valores seriam especificados como: start_time=2017-05-20T15:00:00Z ou start_time=2017-05-21T00:00:00+0900.
Formatos de Offset UTC aceitos
Consulte Time zone designators ISO 8601. Suportado:Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH