Objeto de Dados googleImportJob - Gestão de Campanhas

Artigo
07/19/2024

Define uma tarefa de importação do Google que pode ser executada uma vez ou agendada de forma periódica.

Nota

A partir de 1 de fevereiro de 2023, deixará de poder importar anúncios de texto expandidos do Google Ads. Todos os anúncios de texto expandidos importados antes dessa data podem ser importados novamente e continuaremos a importar alterações de estado (por exemplo, colocar em pausa, anular a utilização) do Google Ads.
Saiba mais sobre esta alteração.

Uma conta pode ter até 100 tarefas de importação agendadas do Google.

Sugestão

Para obter uma descrição geral da implementação, consulte o Guia técnico de Importação de Anúncios do Google .

Sintaxe

<xs:complexType name="GoogleImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ImportJob">
      <xs:sequence>
        <xs:element minOccurs="0" name="CampaignAdGroupIds" nillable="true" type="tns:ArrayOfCampaignAdGroupIds" />
        <xs:element name="CredentialId" nillable="true" type="xs:string" />
        <xs:element name="GoogleAccountId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="GoogleUserName" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto GoogleImportJob tem os seguintes elementos: CampaignAdGroupIds, CredentialId, GoogleAccountId, GoogleUserName.

Elemento	Descrição	Tipo de Dados
CampaignAdGroupIds	A lista de campanhas e os respetivos grupos de anúncios a importar do Google Ads. Os identificadores são guardados, mas não são validados quando cria uma tarefa de importação. Se incluir IDs de campanha ou grupo de anúncios inválidos ou se estes se tornarem inválidos, por exemplo, as entidades serão eliminadas posteriormente do Google Ads, as entidades inválidas serão ignoradas durante a importação. Adicionar: Opcional. Se este elemento não estiver definido, todas as campanhas e grupos de anúncios na conta do Google Ads são elegíveis para importação. O conjunto de entidades importadas também depende das opções de importação. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	CampaignAdGroupIds array (Matriz CampaignAdGroupIds )
CredentialId	Autoriza um utilizador do Google Ads a importar contas para o Microsoft Advertising. Este elemento não é devolvido quando obtém o GoogleImportJob. Veja o guia Obter um ID de Credencial de Importação para obter mais detalhes. Adicionar: Necessário Atualização: Só de leitura	cadeia
GoogleAccountId	A conta do Google Ads a importar. Adicionar: Necessário Atualização: Só de leitura	long
GoogleUserName	A conta Google, ou seja, as credenciais de utilizador do Google com acesso à conta do Google Ads. Adicionar: Só de leitura Atualização: Só de leitura	cadeia

O objeto GoogleImportJob tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do ImportJob

O objeto GoogleImportJob deriva do objeto ImportJob e herda os seguintes elementos: CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type. As descrições abaixo são específicas do GoogleImportJob e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto ImportJob .

Elemento	Descrição	Tipo de Dados
CreatedByUserId	O identificador exclusivo do utilizador do Microsoft Advertising que criou a tarefa de importação. Adicionar: Só de leitura Atualização: Só de leitura	long
CreatedByUserName	O nome de utilizador de início de sessão do utilizador do Microsoft Advertising que criou a tarefa de importação. Adicionar: Só de leitura Atualização: Só de leitura	cadeia
CreatedDateTimeInUTC	A data e hora em que a tarefa de importação foi criada. A data e hora são expressas na Hora Universal Coordenada (UTC). Adicionar: Só de leitura Atualização: Só de leitura	dateTime
Frequência	Determina se a tarefa de importação deve ser executada uma vez ou agendada de forma periódica. Para executar a tarefa de importação agora, este elemento tem de ser nulo ou estar vazio. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Frequência
ID	O identificador exclusivo do Microsoft Advertising da tarefa de importação. Adicionar: Só de leitura Atualização: Só de leitura	long
ImportOption	As opções de importação da Google que estão disponíveis através da API. Para personalizar as opções de importação do Google, pode incluir um objeto GoogleImportOption . Caso contrário, para utilizar as opções de importação predefinidas do Google, pode deixar este elemento nulo ou vazio. Para obter mais informações sobre as opções predefinidas, consulte GoogleImportOption. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	ImportOption
LastRunTimeInUTC	A data e hora de importação mais recentes para esta tarefa. A data e hora são expressas na Hora Universal Coordenada (UTC). Adicionar: Só de leitura Atualização: Só de leitura	dateTime
Nome	O nome da tarefa de importação. O nome pode ter entre 1 e 255 carateres de comprimento. Adicionar: Necessário Atualização: Só de leitura	cadeia
NotificationEmail	O endereço de e-mail para onde os resultados da importação devem ser enviados. Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor NotificationEmail no elemento ReturnAdditionalFields quando chamar as operações do serviço GetImportJobsByIds e GetImportResults . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
NotificationType	Determina se e com que frequência pretende receber notificações por e-mail sobre os resultados da tarefa de importação. Os valores suportados são "Nenhum" (Sem e-mails), "Alterações" (Apenas se existirem alterações ou erros), "Erros" (Apenas se existirem erros) e "EveryTime" (Sempre que esta importação for executada). Adicionar: Opcional. Se não estiver definido, o serviço define este elemento como "Nenhum" por predefinição. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
Estado	O estado da tarefa de importação. Os valores possíveis são Ativos, Em Pausa e Eliminados. As importações agendadas terão um estado Ativo , quer a tarefa seja agendada uma vez ou de forma periódica no futuro. As tarefas de importação em pausa terão o estado Pausa . O estado das tarefas de importação que só são executadas uma vez será definido como Eliminado após a importação. Adicionar: Só de leitura Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
Tipo	O tipo da tarefa de importação. Este valor é GoogleImportJob quando obtém uma tarefa de importação do Google. Para obter mais informações sobre os tipos de tarefas de importação, veja ImportJob Data Object Remarks (Comentários de Objetos de Dados do ImportJob). Adicionar: Só de leitura Atualização: Só de leitura	cadeia

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Compartilhar via