Objet de données GoogleImportJob - Gestion des campagnes

Article
11/14/2024

Définit un travail d’importation Google qui peut être exécuté une seule fois ou planifié de manière périodique.

Remarque

À compter du 1er février 2023, vous ne serez plus en mesure d’importer des annonces textuelles développées à partir de Google Ads. Toutes les annonces textuelles développées importées avant cette étape peuvent être réimportée et nous continuerons à importer status modifications (par exemple, suspendre, annuler lepause) à partir de Google Ads.
En savoir plus sur cette modification.

Un compte peut avoir jusqu’à 100 travaux d’importation Google planifiés.

Conseil

Pour obtenir une vue d’ensemble de l’implémentation, consultez le guide technique d’importation google ads .

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

{
  "CreatedByUserId": "LongValueHere",
  "CreatedByUserName": "ValueHere",
  "CreatedDateTimeInUTC": "ValueHere",
  "Frequency": {
    "Cron": "ValueHere",
    "TimeZone": "ValueHere",
    "Type": "ValueHere"
  },
  "Id": "LongValueHere",
  "ImportOption": {
    "ForwardCompatibilityMap": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ],
    "Type": "FileImportOption"
  },
  "LastRunTimeInUTC": "ValueHere",
  "Name": "ValueHere",
  "NotificationEmail": "ValueHere",
  "NotificationType": "ValueHere",
  "Status": "ValueHere",
  "Type": "GoogleImportJob",
  "CampaignAdGroupIds": [
    {
      "ActiveAdGroupsOnly": "ValueHere",
      "AdGroupIds": [
        "LongValueHere"
      ],
      "CampaignId": "LongValueHere"
    }
  ],
  "CredentialId": "ValueHere",
  "GoogleAccountId": "LongValueHere",
  "GoogleUserName": "ValueHere"
}

Éléments

L’objet GoogleImportJob contient les éléments suivants : CampaignAdGroupIds, CredentialId, GoogleAccountId, GoogleUserName.

Élément	Description	Type de données
CampaignAdGroupIds	Liste des campagnes et de leurs groupes d’annonces à importer à partir de Google Ads. Les identificateurs sont enregistrés, mais non validés lorsque vous créez un travail d’importation. Si vous incluez des ID de campagne ou de groupe d’annonces non valides, ou s’ils deviennent non valides, par exemple, les entités sont supprimées ultérieurement de Google Ads, les entités non valides seront ignorées lors de l’importation. Ajouter: Optionnel. Si cet élément n’est pas défini, toutes les campagnes et groupes d’annonces dans le compte Google Ads peuvent être importés . L’ensemble des entités importées dépend également de vos options d’importation. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	Tableau CampaignAdGroupIds
CredentialId	Autorise un utilisateur Google Ads à importer des comptes dans Microsoft Advertising. Cet élément n’est pas retourné lorsque vous obtenez le GoogleImportJob. Pour plus d’informations, consultez le guide Obtenir un ID d’informations d’identification d’importation . Ajouter: Obligatoire Mettre à jour: En lecture seule	chaîne
GoogleAccountId	Compte Google Ads à importer. Ajouter: Obligatoire Mettre à jour: En lecture seule	long
GoogleUserName	Le compte Google, c’est-à-dire les informations d’identification de l’utilisateur Google ayant accès au compte Google Ads. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

L’objet GoogleImportJob contient des éléments hérités.

Éléments hérités

Éléments hérités d’ImportJob

L’objet GoogleImportJob dérive de l’objet ImportJob et hérite des éléments suivants : CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type. Les descriptions ci-dessous sont spécifiques à GoogleImportJob et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet ImportJob .

Élément	Description	Type de données
CreatedByUserId	Identificateur unique de l’utilisateur Microsoft Advertising qui a créé le travail d’importation. Ajouter: En lecture seule Mettre à jour: En lecture seule	long
CreatedByUserName	Nom d’utilisateur de connexion de l’utilisateur Microsoft Advertising qui a créé le travail d’importation. Ajouter: En lecture seule Mettre à jour: En lecture seule	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). Ajouter: En lecture seule Mettre à jour: En lecture seule	dateTime
Frequency	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. Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	Frequency
Id	Identificateur Microsoft Advertising unique du travail d’importation. Ajouter: En lecture seule Mettre à jour: En lecture seule	long
ImportOption	Options d’importation Google disponibles via l’API. Pour personnaliser les options d’importation Google, vous pouvez inclure un objet GoogleImportOption . Sinon, pour utiliser les options d’importation Google par défaut, vous pouvez laisser cet élément nul ou vide. Pour plus d’informations sur les options par défaut, consultez GoogleImportOption. Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	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). Ajouter: En lecture seule Mettre à jour: En lecture seule	dateTime
Nom	Nom du travail d’importation. Le nom peut comporter entre 1 et 255 caractères. Ajouter: Obligatoire Mettre à jour: En lecture seule	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 . Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	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. Les valeurs prises en charge sont « None » (Aucun e-mail), « Changes » (Uniquement s’il y a des modifications ou des erreurs), « Errors » (Uniquement s’il y a des erreurs) et « EveryTime » (Chaque fois que cette importation s’exécute). Ajouter: Optionnel. S’il n’est pas défini, le service définit cet élément sur « None » par défaut. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	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. Cette valeur est GoogleImportJob lorsque vous récupérez un travail d’importation Google. Pour plus d’informations sur les types de travaux d’importation, consultez les remarques sur l’objet De données ImportJob. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

Configuration requise

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

Partager via