- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CustomAudienceOperation
- MutateCustomAudienceResult
- Pruébala
Crea o actualiza públicos personalizados. Se muestran los estados de la operación.
Lista de errores arrojados: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationError.QuotaErrorRequestError
Solicitud HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
Obligatorio. Es 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 que se deben realizar en públicos personalizados individuales. |
validateOnly |
Si es verdadera, la solicitud se valida, pero no se ejecuta. Solo se muestran errores, no resultados. |
Cuerpo de la respuesta
Mensaje de respuesta para la mutación del 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 de 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 completamente calificados. Ejemplo: |
Campo de unión operation . La operación {i>mutate<i}. 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 que se quitó, en este formato:
|
MutateCustomAudienceResult
El resultado del público personalizado cambia.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
Se muestra para operaciones exitosas. |