Objet de données ImportJob - Gestion des campagnes

Article
12/21/2023

Définit l’objet de base d’un travail d’importation.

Remarque

Mettez à niveau vos annonces textuelles développées en annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne serez plus en mesure de créer ou de modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactive.
Les annonces textuelles développées existantes continueront à être diffusées et vous serez en mesure d’afficher des rapports sur leurs performances.
Vous pourrez toujours suspendre, activer ou supprimer vos annonces textuelles développées.
En savoir plus sur cette modification.

N’essayez pas d’instancier un ImportJob. Vous pouvez créer un ou plusieurs des objets suivants qui en dérivent.

Syntaxe

<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>

Éléments

L’objet ImportJob contient les éléments suivants : CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type.

Élément	Description	Type de données
CreatedByUserId	Identificateur unique de l’utilisateur Microsoft Advertising qui a créé le travail d’importation.	Long
CreatedByUserName	Nom d’utilisateur de connexion de l’utilisateur Microsoft Advertising qui a créé le travail d’importation.	chaîne
CreatedDateTimeInUTC	Date et heure de création du travail d’importation. La date et l’heure sont exprimées en temps universel coordonné (UTC).	dateTime
Fréquence	Détermine si le travail d’importation doit être exécuté une seule fois ou planifié de manière périodique. Pour exécuter le travail d’importation maintenant, cet élément doit être nul ou vide.	Frequency
ID	Identificateur Microsoft Advertising unique du travail d’importation.	Long
ImportOption	Options d’importation disponibles via l’API.	ImportOption
LastRunTimeInUTC	Date et heure d’importation les plus récentes pour ce travail. La date et l’heure sont exprimées en temps universel coordonné (UTC).	dateTime
Nom	Nom du travail d’importation	chaîne
NotificationEmail	Adresse e-mail où les résultats de l’importation doivent être envoyés. Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur NotificationEmail dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetImportJobsByIds et GetImportResults .	chaîne
NotificationType	Détermine si et à quelle fréquence vous souhaitez recevoir des Notifications par e-mail sur les résultats du travail d’importation.	chaîne
Statut	Status du travail d’importation. Les valeurs possibles sont Active, Pause et Deleted. Les importations planifiées auront un status actif, que le travail soit planifié une seule fois ou périodiquement à l’avenir. Les travaux d’importation suspendus auront un status Pause. Le status des travaux d’importation qui ne s’exécutent qu’une seule fois sera défini sur Supprimé après l’importation. Ajouter: En lecture seule Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	chaîne
Type	Type du travail d’importation. Pour plus d’informations sur les types de travaux d’importation, consultez les remarques.	chaîne

Remarques

Si vous générez manuellement le soap, utilisez l’attribut type du <ImportJob> nœud comme indiqué dans l’exemple suivant pour spécifier le type de planification d’importation.

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

Configuration requise

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AddImportJobs
GetImportJobsByIds
ImportResult
UpdateImportJobs

Partager via