Method: customers.recommendations.apply

Aplica las recomendaciones determinadas con los parámetros de aplicación correspondientes.

Lista de errores arrojados: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

Solicitud HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/recommendations:apply

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente con la recomendación.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
Campos
operations[]

object (ApplyRecommendationOperation)

Obligatorio. La lista de operaciones para aplicar recomendaciones. Si partialFailure=false, todas las recomendaciones deben ser del mismo tipo, hay un límite de 100 operaciones por solicitud.
partialFailure

boolean

Si es verdadero, se llevarán a cabo operaciones exitosas y las operaciones no válidas mostrarán errores. Si es falso, las operaciones se llevarán a cabo como una transacción solo si son válidas. El valor predeterminado es falso.

Cuerpo de la respuesta

Mensaje de respuesta para RecommendationService.ApplyRecommendation.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Campos
results[]

object (ApplyRecommendationResult)

Resultados de las operaciones para aplicar recomendaciones.
partialFailureError

object (Status)

Errores relacionados con fallas de operación en el modo de falla parcial. Solo se muestra cuando partialFailure = true y todos los errores ocurren dentro de las operaciones. Si se produce algún error fuera de las operaciones (por ejemplo, errores de autenticación), se muestra el error a nivel de RPC.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/adwords

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ApplyRecommendationOperation

Información sobre la operación para aplicar una recomendación y los parámetros para personalizarla.

Representación JSON 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  },
  "forecastingSetTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
Campos
resourceName

string

El nombre del recurso de la recomendación que se aplicará.
Campo de unión apply_parameters. Parámetros que se deben usar cuando se aplica la recomendación. Las direcciones (apply_parameters) solo pueden ser una de las siguientes opciones:
campaignBudget

object (CampaignBudgetParameters)

Parámetros opcionales que se utilizan al aplicar una recomendación de presupuesto para la campaña.
textAd

object (TextAdParameters)

Parámetros opcionales que se utilizan al aplicar una recomendación de anuncio de texto.
keyword

object (KeywordParameters)

Parámetros opcionales para utilizar al aplicar la recomendación de palabras clave.
targetCpaOptIn

object (TargetCpaOptInParameters)

Parámetros opcionales que se deben utilizar cuando se aplica la recomendación de habilitación del CPA objetivo.
targetRoasOptIn

object (TargetRoasOptInParameters)

Parámetros opcionales que se deben utilizar cuando se aplica la recomendación de habilitación del ROAS objetivo.
calloutExtension

object (CalloutExtensionParameters)

Parámetros que se deben utilizar al aplicar la recomendación de extensión de texto destacado.
callExtension

object (CallExtensionParameters)

Parámetros que se deben utilizar al aplicar la recomendación de extensión de llamada.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

Parámetros que se deben utilizar cuando se aplica la recomendación de transferencia de presupuesto sin utilizar.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

Son los parámetros que se deben usar cuando se aplica una recomendación de anuncio de búsqueda responsivo.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

Son los parámetros que se deben usar al aplicar una recomendación de uso de palabras clave de concordancia amplia.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

Son los parámetros que se deben usar cuando se aplica una recomendación de recursos de anuncios de búsqueda responsivos.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

Los parámetros que se deben utilizar cuando se aplica un anuncio de búsqueda responsivo mejoran la recomendación de calidad del anuncio.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

Son los parámetros que se deben usar cuando se aplica una recomendación de aumento de oferta de CPA objetivo demasiado baja. La aplicación es asíncrona y puede tardar minutos según la cantidad de grupos de anuncios que haya en la campaña relacionada.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

Son los parámetros que se deben usar cuando se aplica una recomendación de ROAS objetivo establecida para las previsiones.
calloutAsset

object (CalloutAssetParameters)

Parámetros que se deben utilizar al aplicar la recomendación de recursos de texto destacado.
callAsset

object (CallAssetParameters)

Parámetros que se deben usar al aplicar la recomendación de recurso de llamada.
raiseTargetCpa

object (RaiseTargetCpaParameters)

Parámetros que se deben usar cuando se aplica la recomendación de aumento de CPA objetivo.
lowerTargetRoas

object (LowerTargetRoasParameters)

Parámetros que se deben usar al aplicar la recomendación de ROAS objetivo más bajo.
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

Son los parámetros que se usarán cuando se aplique la recomendación de establecer una previsión de CPA objetivo.
setTargetCpa

object (ForecastingSetTargetCpaParameters)

Son los parámetros que se deben usar al aplicar la recomendación para establecer un CPA objetivo.
setTargetRoas

object (ForecastingSetTargetRoasParameters)

Son los parámetros que se deben usar al aplicar la recomendación establecida de ROAS objetivo.

CampaignBudgetParameters

Parámetros que se deben utilizar al aplicar una recomendación de presupuesto para la campaña.

Representación JSON 
{
  "newBudgetAmountMicros": string
}
Campos
newBudgetAmountMicros

string (int64 format)

Es el nuevo importe del presupuesto que se establecerá para el recurso de presupuesto objetivo. Éste es un campo obligatorio.

TextAdParameters

Parámetros que se deben utilizar al aplicar una recomendación de anuncio de texto.

Representación JSON 
{
  "ad": {
    object (Ad)
  }
}
Campos
ad

object (Ad)

Es un anuncio nuevo para agregar al grupo de anuncios recomendado. En este mensaje, se deben establecer todos los campos necesarios. Éste es un campo obligatorio.

KeywordParameters

Parámetros que se deben usar al aplicar la recomendación de palabras clave.

Representación JSON 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
Campos
matchType

enum (KeywordMatchType)

El tipo de concordancia de la palabra clave. Éste es un campo obligatorio.
adGroup

string

El recurso del grupo de anuncios al que se agregará la palabra clave. Éste es un campo obligatorio.
cpcBidMicros

string (int64 format)

Opcional: Oferta de CPC que se establecerá para la palabra clave. Si no se establece, la palabra clave utilizará la oferta según la estrategia de oferta que utilice el grupo de anuncios objetivo.

TargetCpaOptInParameters

Parámetros que se deben utilizar al aplicar la recomendación de CPA objetivo.

Representación JSON 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
Campos
targetCpaMicros

string (int64 format)

CPA promedio para utilizar en la estrategia de oferta de CPA objetivo. Éste es un campo obligatorio.
newCampaignBudgetAmountMicros

string (int64 format)

Opcional: Es el importe del presupuesto que se establecerá para la campaña.

TargetRoasOptInParameters

Son los parámetros que se deben usar al aplicar una recomendación para habilitar el ROAS objetivo.

Representación JSON 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
Campos
targetRoas

number

ROAS (ingresos por unidad de inversión) promedio que se utilizará en la estrategia de ofertas ROAS objetivo. El valor está entre 0.01 y 1, 000.0 inclusive. Este es un campo obligatorio, a menos que se configure newCampaignBudgetAmountMicros.
newCampaignBudgetAmountMicros

string (int64 format)

Opcional: Es el importe del presupuesto que se establecerá para la campaña.

CalloutExtensionParameters

Parámetros que se deben utilizar al aplicar la recomendación de extensión de texto destacado.

Representación JSON 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
Campos
calloutExtensions[]

object (CalloutFeedItem)

Se agregarán las extensiones de texto destacado. Éste es un campo obligatorio.

CallExtensionParameters

Parámetros que se deben utilizar al aplicar la recomendación de extensión de llamada.

Representación JSON 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
Campos
callExtensions[]

object (CallFeedItem)

Se agregarán las extensiones de llamada. Éste es un campo obligatorio.

SitelinkExtensionParameters

Parámetros que se deben utilizar al aplicar la recomendación de vínculo a sitio.

Representación JSON 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
Campos

MoveUnusedBudgetParameters

Parámetros que se deben utilizar cuando se aplica la recomendación de transferencia de presupuesto sin utilizar.

Representación JSON 
{
  "budgetMicrosToMove": string
}
Campos
budgetMicrosToMove

string (int64 format)

Importe del presupuesto para pasar del presupuesto excedente al limitado. Éste es un campo obligatorio.

ResponsiveSearchAdParameters

Son los parámetros que se deben usar cuando se aplica una recomendación de anuncio de búsqueda responsivo.

Representación JSON 
{
  "ad": {
    object (Ad)
  }
}
Campos
ad

object (Ad)

Obligatorio. Es un anuncio nuevo para agregar al grupo de anuncios recomendado.

UseBroadMatchKeywordParameters

Son los parámetros que se deben usar al aplicar una recomendación de uso de palabras clave de concordancia amplia.

Representación JSON 
{
  "newBudgetAmountMicros": string
}
Campos
newBudgetAmountMicros

string (int64 format)

Es el nuevo importe del presupuesto que se establecerá para el recurso de presupuesto objetivo.

ResponsiveSearchAdAssetParameters

Son los parámetros que se deben usar cuando se aplica una recomendación de recursos de anuncios de búsqueda responsivos.

Representación JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
Campos
updatedAd

object (Ad)

Anuncio actualizado. Se reemplazará el contenido del anuncio actual.

ResponsiveSearchAdImproveAdStrengthParameters

Los parámetros que se deben utilizar cuando se aplica un anuncio de búsqueda responsivo mejoran la recomendación de calidad del anuncio.

Representación JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
Campos
updatedAd

object (Ad)

Anuncio actualizado. Se reemplazará el contenido del anuncio actual.

RaiseTargetCpaBidTooLowParameters

Son los parámetros que se deben usar cuando se aplica una recomendación de aumento de oferta de CPA objetivo demasiado baja. La aplicación es asíncrona y puede tardar minutos según la cantidad de grupos de anuncios que haya en la campaña relacionada.

Representación JSON 
{
  "targetMultiplier": number
}
Campos
targetMultiplier

number

Obligatorio. Un número superior a 1.0 que indica el factor por el que se debe aumentar el CPA objetivo. Éste es un campo obligatorio.

ForecastingSetTargetRoasParameters

Son los parámetros que se usan cuando se aplica una recomendación de ROAS objetivo establecida de previsión.

Representación JSON 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
Campos
targetRoas

number

Nuevo ROAS (ingresos por unidad de inversión) objetivo que se establecerá para un recurso de campaña El valor está entre 0.01 y 1, 000.0 inclusive.
campaignBudgetAmountMicros

string (int64 format)

Es el nuevo importe del presupuesto de la campaña que se establecerá para un recurso de campaña.

CalloutAssetParameters

Son los parámetros que se deben usar cuando se aplican las recomendaciones de recursos de texto destacado.

Representación JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Campos
adAssetApplyParameters

object (AdAssetApplyParameters)

Obligatorio. Recursos de texto destacado que se agregarán. Éste es un campo obligatorio.

AdAssetApplyParameters

Son los parámetros comunes que se usan al aplicar las recomendaciones de recursos del anuncio.

Representación JSON 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
Campos
newAssets[]

object (Asset)

Los recursos que se deben crear y adjuntar a un alcance. Puede combinarse con elementos existentes de la misma llamada.
existingAssets[]

string

Los nombres de recursos de elementos existentes que se adjuntarán a un alcance. Se puede combinar con newAssets en la misma llamada.
scope

enum (ApplyScope)

Obligatorio. El alcance en el que se aplican los activos. Los recursos a nivel del alcance de la campaña se aplicarán a la campaña asociada con la recomendación. Los recursos al alcance del cliente se aplicarán a toda la cuenta. Los recursos en el alcance de la campaña anularán los adjuntos al alcance del cliente.

ApplyScope

Alcance al que se aplicarán los recursos.

Enumeradores
UNSPECIFIED No se especificó el alcance de aplicación.
UNKNOWN Desconocido.
CUSTOMER Aplicar en función del alcance del cliente.
CAMPAIGN Aplicar en el alcance de la campaña

CallAssetParameters

Parámetros que se deben utilizar al aplicar las recomendaciones de recursos de llamada.

Representación JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Campos
adAssetApplyParameters

object (AdAssetApplyParameters)

Obligatorio. Se deben agregar los recursos de llamada. Éste es un campo obligatorio.

SitelinkAssetParameters

Parámetros que se deben usar al aplicar las recomendaciones de recursos de vínculos a sitios.

Representación JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Campos
adAssetApplyParameters

object (AdAssetApplyParameters)

Obligatorio. Se agregarán los recursos de vínculo a sitio. Éste es un campo obligatorio.

RaiseTargetCpaParameters

Parámetros que se deben usar cuando se aplican recomendaciones de aumento del CPA objetivo.

Representación JSON 
{
  "targetCpaMultiplier": number
}
Campos
targetCpaMultiplier

number

Obligatorio. Objetivo para establecer el multiplicador de CPA. Éste es un campo obligatorio.

LowerTargetRoasParameters

Parámetros que se deben usar al aplicar recomendaciones de ROAS objetivo más bajo.

Representación JSON 
{
  "targetRoasMultiplier": number
}
Campos
targetRoasMultiplier

number

Obligatorio. Objetivo para establecer el multiplicador de ROAS. Éste es un campo obligatorio.

ForecastingSetTargetCpaParameters

Son los parámetros que se deben usar cuando se aplica una recomendación de CPA objetivo establecida.

Representación JSON 
{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}
Campos
targetCpaMicros

string (int64 format)

CPA promedio para utilizar en la estrategia de oferta de CPA objetivo.
campaignBudgetAmountMicros

string (int64 format)

Es el nuevo importe del presupuesto de la campaña que se establecerá para un recurso de campaña.

ApplyRecommendationResult

Es el resultado de aplicar una recomendación.

Representación JSON 
{
  "resourceName": string
}
Campos
resourceName

string

Se muestra para aplicaciones exitosas.