Objeto de datos GoogleImportJob: Administración de campañas

Define un trabajo de importación de Google que se puede ejecutar una vez o programar de forma periódica.

Nota:

• A partir del 1 de febrero de 2023, ya no podrás importar anuncios de texto expandido de Google Ads. Los anuncios de texto expandidos importados antes de entonces se pueden volver a importar y continuaremos importando los cambios de estado (por ejemplo, pausar, anular el uso) de Google Ads.
• Obtenga más información sobre este cambio.

Una cuenta puede tener hasta 100 trabajos programados de importación de Google.

Sugerencia

Para obtener información general sobre la implementación, consulte la guía técnica de importación de Google Ads .

XML

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

JSON

{
  "CreatedByUserId": "LongValueHere",
  "CreatedByUserName": "ValueHere",
  "CreatedDateTimeInUTC": "ValueHere",
  "Frequency": {
    "Cron": "ValueHere",
    "TimeZone": "ValueHere",
    "Type": "ValueHere"
  },
  "Id": "LongValueHere",
  "ImportOption": {
    "ForwardCompatibilityMap": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ],
    "Type": "GoogleImportOption",
    "AccountUrlOptions": "ValueHere",
    "AdjustmentForBids": DoubleValueHere,
    "AdjustmentForCampaignBudgets": DoubleValueHere,
    "AdScheduleUseSearcherTimezone": "ValueHere",
    "AssociatedStoreId": "LongValueHere",
    "AssociatedUetTagId": "LongValueHere",
    "AutoDeviceBidOptimization": "ValueHere",
    "DeleteRemovedEntities": "ValueHere",
    "EnableAutoCurrencyConversion": "ValueHere",
    "EnableParentLocationMapping": "ValueHere",
    "NewAccountNegativeKeywords": "ValueHere",
    "NewActiveAdsForExistingAdGroups": "ValueHere",
    "NewActiveCampaignsAndChildEntities": "ValueHere",
    "NewAdCustomizerFeeds": "ValueHere",
    "NewAdGroupsAndChildEntitiesForExistingCampaigns": "ValueHere",
    "NewAdSchedules": "ValueHere",
    "NewAppAdExtensions": "ValueHere",
    "NewAudienceTargets": "ValueHere",
    "NewBrandSuitability": "ValueHere",
    "NewCallAdExtensions": "ValueHere",
    "NewCalloutAdExtensions": "ValueHere",
    "NewConversionGoals": "ValueHere",
    "NewDemographicTargets": "ValueHere",
    "NewDeviceTargets": "ValueHere",
    "NewEntities": "ValueHere",
    "NewImageAdExtensions": "ValueHere",
    "NewKeywordsForExistingAdGroups": "ValueHere",
    "NewKeywordUrls": "ValueHere",
    "NewLabels": "ValueHere",
    "NewLeadFormAdExtensions": "ValueHere",
    "NewLocationAdExtensions": "ValueHere",
    "NewLocationTargets": "ValueHere",
    "NewLogoAdExtensions": "ValueHere",
    "NewNegativeKeywordLists": "ValueHere",
    "NewNegativeKeywordsForExistingParents": "ValueHere",
    "NewNegativeSites": "ValueHere",
    "NewPageFeeds": "ValueHere",
    "NewPausedAdsForExistingAdGroups": "ValueHere",
    "NewPausedCampaignsAndChildEntities": "ValueHere",
    "NewPriceAdExtensions": "ValueHere",
    "NewProductFilters": "ValueHere",
    "NewPromotionAdExtensions": "ValueHere",
    "NewReviewAdExtensions": "ValueHere",
    "NewSitelinkAdExtensions": "ValueHere",
    "NewStructuredSnippetAdExtensions": "ValueHere",
    "NewUrlOptions": "ValueHere",
    "PauseAIMAdGroupIfAllAudienceCriterionNotImported": "ValueHere",
    "PauseCampaignsWithoutSupportedLocations": "ValueHere",
    "PauseNewCampaigns": "ValueHere",
    "RaiseBidsToMinimum": "ValueHere",
    "RaiseCampaignBudgetsToMinimum": "ValueHere",
    "RaiseProductGroupBidsToMinimum": "ValueHere",
    "RenameCampaignNameWithSuffix": "ValueHere",
    "SearchAndDsaMixedCampaignAsSearchCampaign": "ValueHere",
    "SearchAndReplaceForCampaignNames": {
      "ReplaceString": "ValueHere",
      "SearchString": "ValueHere"
    },
    "SearchAndReplaceForCustomParameters": {
      "ReplaceString": "ValueHere",
      "SearchString": "ValueHere"
    },
    "SearchAndReplaceForFinalURLSuffix": {
      "ReplaceString": "ValueHere",
      "SearchString": "ValueHere"
    },
    "SearchAndReplaceForTrackingTemplates": {
      "ReplaceString": "ValueHere",
      "SearchString": "ValueHere"
    },
    "SearchAndReplaceForUrls": {
      "ReplaceString": "ValueHere",
      "SearchString": "ValueHere"
    },
    "SuffixForCampaignNames": "ValueHere",
    "SuffixForTrackingTemplates": "ValueHere",
    "SuffixForUrls": "ValueHere",
    "UpdateAccountNegativeKeywords": "ValueHere",
    "UpdateAdCustomizerAttributes": "ValueHere",
    "UpdateAdCustomizerFeeds": "ValueHere",
    "UpdateAdGroupNetwork": "ValueHere",
    "UpdateAdSchedules": "ValueHere",
    "UpdateAdUrls": "ValueHere",
    "UpdateAppAdExtensions": "ValueHere",
    "UpdateAudienceTargets": "ValueHere",
    "UpdateBiddingStrategies": "ValueHere",
    "UpdateBids": "ValueHere",
    "UpdateBrandSuitability": "ValueHere",
    "UpdateCallAdExtensions": "ValueHere",
    "UpdateCalloutAdExtensions": "ValueHere",
    "UpdateCampaignAdGroupLanguages": "ValueHere",
    "UpdateCampaignBudgets": "ValueHere",
    "UpdateCampaignNames": "ValueHere",
    "UpdateConversionGoals": "ValueHere",
    "UpdateDemographicTargets": "ValueHere",
    "UpdateDeviceTargets": "ValueHere",
    "UpdateEntities": "ValueHere",
    "UpdateImageAdExtensions": "ValueHere",
    "UpdateKeywordUrls": "ValueHere",
    "UpdateLabels": "ValueHere",
    "UpdateLeadFormAdExtensions": "ValueHere",
    "UpdateLocationAdExtensions": "ValueHere",
    "UpdateLocationTargets": "ValueHere",
    "UpdateLogoAdExtensions": "ValueHere",
    "UpdateNegativeKeywordLists": "ValueHere",
    "UpdateNegativeSites": "ValueHere",
    "UpdatePageFeeds": "ValueHere",
    "UpdatePriceAdExtensions": "ValueHere",
    "UpdateProductFilters": "ValueHere",
    "UpdatePromotionAdExtensions": "ValueHere",
    "UpdateReviewAdExtensions": "ValueHere",
    "UpdateSitelinkAdExtensions": "ValueHere",
    "UpdateSitelinkUrls": "ValueHere",
    "UpdateStatusForAdGroups": "ValueHere",
    "UpdateStatusForAds": "ValueHere",
    "UpdateStatusForCampaigns": "ValueHere",
    "UpdateStatusForKeywords": "ValueHere",
    "UpdateStructuredSnippetAdExtensions": "ValueHere",
    "UpdateUrlOptions": "ValueHere"
  },
  "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"
}

Elementos

El objeto GoogleImportJob tiene los siguientes elementos: CampaignAdGroupIds, CredentialId, GoogleAccountId, GoogleUserName.

Elemento	Descripción	Tipo de datos
CampaignAdGroupIds	La lista de campañas y sus grupos de anuncios que se van a importar desde Google Ads. Los identificadores se guardan pero no se validan al crear un trabajo de importación. Si incluye identificadores de campaña o grupo de anuncios no válidos, o si no son válidos, por ejemplo, las entidades se eliminan más adelante de Google Ads, las entidades no válidas se omitirán durante la importación. Agregar: Opcional. Si este elemento no está establecido, todas las campañas y grupos de anuncios de la cuenta de Google Ads son aptos para la importación. El conjunto de entidades importadas también depende de las opciones de importación. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Matriz CampaignAdGroupIds
CredentialId	Autoriza a un usuario de Google Ads a importar cuentas a Microsoft Advertising. Este elemento no se devuelve cuando se obtiene GoogleImportJob. Consulte la guía Obtener un identificador de credencial de importación para obtener más detalles. Agregar: Obligatorio Actualizar: Solo lectura	string
GoogleAccountId	La cuenta de Google Ads que se va a importar. Agregar: Obligatorio Actualizar: Solo lectura	largo
GoogleUserName	La cuenta de Google, es decir, las credenciales de usuario de Google con acceso a la cuenta de Google Ads. Agregar: Solo lectura Actualizar: Solo lectura	string

El objeto GoogleImportJob tiene elementos heredados.

Elementos heredados

Elementos heredados de ImportJob

El objeto GoogleImportJob deriva del objeto ImportJob y hereda los siguientes elementos: CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type. Las descripciones siguientes son específicas de GoogleImportJob y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto ImportJob .

Elemento	Descripción	Tipo de datos
CreatedByUserId	Identificador único del usuario de Microsoft Advertising que creó el trabajo de importación. Agregar: Solo lectura Actualizar: Solo lectura	largo
CreatedByUserName	Nombre de usuario de inicio de sesión del usuario de Microsoft Advertising que creó el trabajo de importación. Agregar: Solo lectura Actualizar: Solo lectura	string
CreatedDateTimeInUTC	Fecha y hora en que se creó el trabajo de importación. La fecha y hora se expresan en hora universal coordinada (UTC). Agregar: Solo lectura Actualizar: Solo lectura	dateTime
Frecuencia	Determina si el trabajo de importación debe ejecutarse una vez o programarse periódicamente. Para ejecutar el trabajo de importación ahora, este elemento debe ser nulo o vacío. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Frequency
Identificación	Identificador único de Microsoft Advertising del trabajo de importación. Agregar: Solo lectura Actualizar: Solo lectura	largo
ImportOption	Las opciones de importación de Google que están disponibles a través de la API. Para personalizar las opciones de importación de Google, puede incluir un objeto GoogleImportOption . De lo contrario, para usar las opciones de importación predeterminadas de Google, puede dejar este elemento vacío o nulo. Para obtener más información sobre las opciones predeterminadas, consulte GoogleImportOption. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	ImportOption
LastRunTimeInUTC	Fecha y hora de importación más recientes para este trabajo. La fecha y hora se expresan en hora universal coordinada (UTC). Agregar: Solo lectura Actualizar: Solo lectura	dateTime
Nombre	Nombre del trabajo de importación. El nombre puede tener entre 1 y 255 caracteres. Agregar: Obligatorio Actualizar: Solo lectura	string
NotificationEmail	Dirección de correo electrónico donde se deben enviar los resultados de importación. Este elemento no se devuelve de forma predeterminada. Para obtener este elemento, incluya el valor NotificationEmail en el elemento ReturnAdditionalFields cuando llame a las operaciones de servicio GetImportJobsByIds y GetImportResults . Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
NotificationType	Determina si quiere recibir notificaciones por correo electrónico sobre los resultados del trabajo de importación y con qué frecuencia. Los valores admitidos son "None" (Sin correos electrónicos), "Changes" (Only if there are changes or errors), "Errors" (Only if there are errors) y "EveryTime" (EveryTime) (Cada vez que se ejecuta esta importación). Agregar: Opcional. Si no se establece, el servicio establece este elemento en "None" de forma predeterminada. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
Estado	Estado del trabajo de importación. Los valores posibles son Active, Pause y Deleted. Las importaciones programadas tendrán un estado Activo , independientemente de si el trabajo se programa una vez o de forma periódica en el futuro. Los trabajos de importación en pausa tendrán un estado De pausa . El estado de los trabajos de importación que solo se ejecutan una vez se establecerá en Eliminado después de la importación. Agregar: Solo lectura Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
Tipo	Tipo del trabajo de importación. Este valor es GoogleImportJob cuando se recupera un trabajo de importación de Google. Para obtener más información sobre los tipos de trabajo de importación, vea los comentarios del objeto de datos ImportJob. Agregar: Solo lectura Actualizar: Solo lectura	string

Requisitos

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