- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
Agrega operaciones al trabajo por lotes.
Lista de errores arrojados: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
Solicitud HTTP
POST https://googleads.googleapis.com/v16/{resourceName=customers/*/batchJobs/*}:addOperations
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
resourceName |
Obligatorio. El nombre del recurso del trabajo por lotes. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
Campos | |
---|---|
sequenceToken |
Un token que se usa para aplicar la secuencia. La primera solicitud batchJobs.addOperations para un trabajo por lotes no debe establecer secuenciaToken. Las solicitudes posteriores deben establecer este token en el valor de nextSequenceToken recibido en la respuesta anterior batchJobs.addOperations. |
mutateOperations[] |
Obligatorio. La lista de mutaciones que se agregan. Las operaciones pueden usar números enteros negativos como IDs temporales para indicar dependencias entre entidades creadas en este trabajo por lotes. Por ejemplo, un cliente con el ID = 1234 puede crear una campaña y un grupo de anuncios en esa misma campaña. Para ello, debe crear una campaña en la primera operación con el nombre del recurso establecido explícitamente en "customers/1234/campaigns/-1", y un grupo de anuncios en la segunda operación con el campo de campaña configurado también en "customers/1234/campaigns/-1". |
Cuerpo de la respuesta
Mensaje de respuesta para BatchJobService.AddBatchJobOperations
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "totalOperations": string, "nextSequenceToken": string } |
Campos | |
---|---|
totalOperations |
La cantidad total de operaciones agregadas hasta el momento para este trabajo por lotes. |
nextSequenceToken |
El token de secuencia que se utilizará cuando se vuelva a llamar a batchJobs.addOperations si deben agregarse más operaciones. La siguiente solicitud batchJobs.addOperations debe establecer el campo secuenciaToken en el valor de este campo. |
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.