- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CustomAudienceOperation
- MutateCustomAudienceResult
- Pruébalo
Crea o actualiza públicos personalizados. Se muestran los estados de las operaciones.
Lista de errores arrojados: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationErrorPolicyViolationError PolicyViolationErrorQuotaErrorRequestError
Solicitud HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/customAudiences:mutate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
Obligatorio. El ID del cliente cuyos públicos personalizados se modifican. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"operations": [
{
object ( |
Campos | |
---|---|
operations[] |
Obligatorio. Es la lista de operaciones para realizar en públicos personalizados individuales. |
validateOnly |
Si es verdadero, la solicitud se valida, pero no se ejecuta. Solo se muestran errores, no resultados. |
Cuerpo de la respuesta
Mensaje de respuesta para el cambio de público personalizado.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"results": [
{
object ( |
Campos | |
---|---|
results[] |
Todos los resultados para la función {i>mutate<i}. |
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.
CustomAudienceOperation
Una sola operación (crear, actualizar) en un público personalizado.
Representación JSON |
---|
{ "updateMask": string, // Union field |
Campos | |
---|---|
updateMask |
FieldMask que determina qué campos de recursos se modifican en una actualización. Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: |
Campo de unión operation . Es la operación de mutación. Las direcciones (operation ) solo pueden ser una de las siguientes opciones: |
|
create |
Operación de creación: No se espera ningún nombre de recurso para el nuevo público personalizado. |
update |
Operación de actualización: Se espera que el público personalizado tenga un nombre de recurso válido. |
remove |
Operación de eliminación: Se espera un nombre de recurso para el público personalizado quitado en el siguiente formato:
|
MutateCustomAudienceResult
El resultado de la modificación del público personalizado.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
Se muestra para las operaciones correctas. |