ImportJob Data Object - Gestão de Campanhas

Artigo
12/21/2023

Define o objeto base de uma tarefa de importação.

Nota

Atualize os anúncios de texto expandidos para anúncios de pesquisa reativos até 1 de fevereiro de 2023. Após esta data, deixará de poder criar anúncios de texto expandido novos ou editar existentes. Para obter mais informações, consulte Acerca dos anúncios de pesquisa reativos.
Os anúncios de texto expandido existentes continuarão a servir e poderá ver relatórios sobre o desempenho dos mesmos.
Continuará a poder colocar em pausa, ativar ou remover os anúncios de texto expandidos.
Saiba mais sobre esta alteração.

Não tente instanciar um ImportJob. Pode criar um ou mais dos seguintes objetos que derivam do mesmo.

Sintaxe

<xs:complexType name="ImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CreatedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CreatedByUserName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CreatedDateTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Frequency" nillable="true" type="tns:Frequency" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ImportOption" nillable="true" type="tns:ImportOption" />
    <xs:element minOccurs="0" name="LastRunTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="NotificationEmail" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="NotificationType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto ImportJob tem os seguintes elementos: CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type.

Elemento	Descrição	Tipo de Dados
CreatedByUserId	O identificador exclusivo do utilizador do Microsoft Advertising que criou a tarefa de importação.	long
CreatedByUserName	O nome de utilizador de início de sessão do utilizador do Microsoft Advertising que criou a tarefa de importação.	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).	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 deve ser nulo ou estar vazio.	Frequência
ID	O identificador exclusivo do Microsoft Advertising da tarefa de importação.	long
ImportOption	As opções de importação que estão disponíveis através da API.	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).	dateTime
Nome	O nome da tarefa de importação	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 .	cadeia
NotificationType	Determina se e com que frequência pretende receber notificações por e-mail sobre os resultados da tarefa de importação.	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. Para obter mais informações sobre os tipos de tarefas de importação, consulte as Observações.	cadeia

Observações

Se gerar o SOAP manualmente, utilize o atributo type do <ImportJob> nó, conforme mostrado no exemplo seguinte, para especificar o tipo de agenda de importação.

<ImportJob i:type="GoogleImportJob" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</ImportJob>

Requisitos

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

Utilizado Por

AddImportJobs
GetImportJobsByIds
ImportResult
UpdateImportJobs

Partilhar via