Oggetto dati GoogleImportJob - Campaign Management

Definisce un processo di importazione di Google che può essere eseguito una volta o pianificato su base ricorrente.

Nota

  • A partire dal 1° febbraio 2023, non potrai più importare annunci di testo espansi da Google Ads. Tutti gli annunci di testo espansi importati prima di allora possono essere reimportati e continueremo a importare le modifiche di stato (ad esempio, pausa, annullamento della pubblicazione) da Google Ads.
  • Altre informazioni su questa modifica.

Un account può avere fino a 100 processi di importazione pianificati di Google.

Consiglio

Per una panoramica dell'implementazione, vedere la guida tecnica per l'importazione di Google Ads .

Sintassi

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

Elementi

L'oggetto GoogleImportJob include gli elementi seguenti: CampaignAdGroupIds, CredentialId, GoogleAccountId, GoogleUserName.

Elemento Descrizione Tipo di dati
CampaignAdGroupIds Elenco di campagne e gruppi di annunci da importare da Google Ads.

Gli identificatori vengono salvati ma non convalidati quando si crea un processo di importazione. Se includi ID campagna o gruppo di annunci non validi o se diventano non validi, ad esempio, le entità vengono eliminate in un secondo momento da Google Ads, le entità non valide verranno ignorate durante l'importazione.

Aggiungere: Opzionale. Se questo elemento non è impostato, tutte le campagne e i gruppi di annunci nell'account Google Ads sono idonei per l'importazione. Il set di entità importate dipende anche dalle opzioni di importazione.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Matrice CampaignAdGroupIds
CredentialId Autorizza un utente di Google Ads a importare account in Microsoft Advertising.

Questo elemento non viene restituito quando si ottiene GoogleImportJob.

Per altri dettagli, vedere la guida Get an Import Credential ID (Ottenere un ID credenziali di importazione ).

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Stringa
GoogleAccountId Account Google Ads da importare.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
long
GoogleUserName L'account Google, ad esempio le credenziali utente di Google con accesso all'account Google Ads.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Stringa

L'oggetto GoogleImportJob include elementi ereditati.

Elementi ereditati

Elementi ereditati da ImportJob

L'oggetto GoogleImportJob deriva dall'oggetto ImportJob ed eredita gli elementi seguenti: CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type. Le descrizioni seguenti sono specifiche di GoogleImportJob e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto ImportJob .

Elemento Descrizione Tipo di dati
CreatedByUserId Identificatore univoco dell'utente di Microsoft Advertising che ha creato il processo di importazione.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
CreatedByUserName Nome utente di accesso dell'utente di Microsoft Advertising che ha creato il processo di importazione.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Stringa
CreatedDateTimeInUTC Data e ora di creazione del processo di importazione.

La data e l'ora sono espresse nell'ora UTC (Coordinated Universal Time).

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Datetime
Frequenza Determina se il processo di importazione deve essere eseguito una volta o pianificato su base ricorrente.

Per eseguire il processo di importazione, questo elemento deve essere nil o vuoto.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Frequenza
Id Identificatore univoco di Microsoft Advertising del processo di importazione.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
ImportOption Opzioni di importazione di Google disponibili tramite API.

Per personalizzare le opzioni di importazione di Google, è possibile includere un oggetto GoogleImportOption . In caso contrario, per usare le opzioni di importazione predefinite di Google, è possibile lasciare questo elemento nil o vuoto. Per altre informazioni sulle opzioni predefinite, vedere GoogleImportOption.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
ImportOption
LastRunTimeInUTC Data e ora di importazione più recenti per questo processo.

La data e l'ora sono espresse nell'ora UTC (Coordinated Universal Time).

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Datetime
Nome Nome del processo di importazione.

Il nome può avere una lunghezza compresa tra 1 e 255 caratteri.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Stringa
NotificationEmail Indirizzo di posta elettronica in cui inviare i risultati dell'importazione.

Questo elemento non viene restituito per impostazione predefinita. Per ottenere questo elemento, includere il valore NotificationEmail nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetImportJobsByIds e GetImportResults .

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Stringa
NotificationType Determina se e con quale frequenza si desidera ricevere notifiche tramite posta elettronica sui risultati del processo di importazione.

I valori supportati sono "None" (Nessun messaggio di posta elettronica), "Changes" (Only if there are changes or errors), "Errors" (Only if there are errors) e "EveryTime" (Ogni volta che viene eseguita l'importazione).

Aggiungere: Opzionale. Se non è impostato, il servizio imposta questo elemento su "None" per impostazione predefinita.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Stringa
Stato Stato del processo di importazione.

I valori possibili sono Attivo, Sospendi ed Eliminato. Le importazioni pianificate avranno uno stato Attivo , indipendentemente dal fatto che il processo sia pianificato una volta o su base ricorrente in futuro. I processi di importazione sospesi avranno uno stato Di sospensione . Lo stato dei processi di importazione eseguiti una sola volta verrà impostato su Eliminato dopo l'importazione.

Aggiungere: Sola lettura
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Stringa
Digitare Tipo del processo di importazione.

Questo valore è GoogleImportJob quando si recupera un processo di importazione di Google.

Per altre informazioni sui tipi di processo di importazione, vedere Le osservazioni sull'oggetto dati ImportJob.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Stringa

Requisiti

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