Atualizar Objetos de Anúncios

curl --request PUT \
  --url https://api.metrito.com/v3/connections/{connection_id}/objects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "campaign",
  "updates": [
    {
      "id": "120215678901234567",
      "status": "PAUSED"
    }
  ]
}
'

{
  "success": true,
  "summary": {
    "total": 2,
    "successful": 2,
    "failed": 0
  },
  "results": [
    {
      "id": "120215678901234567",
      "success": true,
      "error": null
    },
    {
      "id": "120215678901234568",
      "success": true,
      "error": null
    }
  ]
}

{
  "success": false,
  "summary": {
    "total": 2,
    "successful": 1,
    "failed": 1
  },
  "results": [
    {
      "id": "120215678901234567",
      "success": true,
      "error": null
    },
    {
      "id": "120215678901234568",
      "success": false,
      "error": {
        "message": "Campaign is not active and cannot be paused",
        "code": 1487065
      }
    }
  ]
}

{
  "success": false,
  "error": {
    "type": "validation_error",
    "code": "invalid_parameter",
    "message": "type must be one of: campaign, adset, ad"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "type": "not_found_error",
    "code": "resource_not_found",
    "message": "Connection \"act_123456789\" not found in this workspace."
  }
}

{
  "success": false,
  "error": {
    "type": "platform_error",
    "code": "PLATFORM_NOT_SUPPORTED",
    "message": "Platform \"google-ads\" does not support ad management operations yet."
  }
}

PUT

connections

{connection_id}

objects

curl --request PUT \
  --url https://api.metrito.com/v3/connections/{connection_id}/objects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "campaign",
  "updates": [
    {
      "id": "120215678901234567",
      "status": "PAUSED"
    }
  ]
}
'

{
  "success": true,
  "summary": {
    "total": 2,
    "successful": 2,
    "failed": 0
  },
  "results": [
    {
      "id": "120215678901234567",
      "success": true,
      "error": null
    },
    {
      "id": "120215678901234568",
      "success": true,
      "error": null
    }
  ]
}

{
  "success": false,
  "summary": {
    "total": 2,
    "successful": 1,
    "failed": 1
  },
  "results": [
    {
      "id": "120215678901234567",
      "success": true,
      "error": null
    },
    {
      "id": "120215678901234568",
      "success": false,
      "error": {
        "message": "Campaign is not active and cannot be paused",
        "code": 1487065
      }
    }
  ]
}

{
  "success": false,
  "error": {
    "type": "validation_error",
    "code": "invalid_parameter",
    "message": "type must be one of: campaign, adset, ad"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "type": "not_found_error",
    "code": "resource_not_found",
    "message": "Connection \"act_123456789\" not found in this workspace."
  }
}

{
  "success": false,
  "error": {
    "type": "platform_error",
    "code": "PLATFORM_NOT_SUPPORTED",
    "message": "Platform \"google-ads\" does not support ad management operations yet."
  }
}

Identificando a conexão

O parâmetro connectionId aceita dois formatos:

Formato	Exemplo	Quando usar
ID Metrito	`64a1b2c3d4e5f6a7b8c9d0e1`	Padrão — obtido via `GET /v3/projects/:id/connections`
ID da conta Meta	`act_123456789` ou `123456789`	Quando você já tem o ID da conta de anúncios

Tipos de objeto suportados

`type`	O que representa
`campaign`	Campanha
`adset`	Conjunto de anúncios
`ad`	Anúncio individual

Operações por objeto

Operação	Campo	Valores aceitos	Suporta
Pausar / Ativar	`status`	`"ACTIVE"`, `"PAUSED"`	campaign, adset, ad
Alterar orçamento	`budget`	Inteiro positivo em centavos	campaign, adset

Nota: Anúncios não possuem orçamento próprio. Use campaign ou adset para alterar orçamento.

Misturar operações em uma chamada

Você pode misturar operações de status e budget no mesmo array updates. O Metrito agrupa e processa cada tipo separadamente.

Exemplos de uso

Pausar uma campanha:

{
  "type": "campaign",
  "updates": [
    { "id": "120215678901234567", "status": "PAUSED" }
  ]
}

Ativar múltiplos anúncios:

{
  "type": "ad",
  "updates": [
    { "id": "120215678901234567", "status": "ACTIVE" },
    { "id": "120215678901234568", "status": "ACTIVE" }
  ]
}

Alterar orçamento de múltiplas campanhas:

{
  "type": "campaign",
  "updates": [
    { "id": "120215678901234567", "budget": 10000 },
    { "id": "120215678901234568", "budget": 5000 }
  ]
}

Pausar e alterar orçamento na mesma chamada:

{
  "type": "campaign",
  "updates": [
    { "id": "120215678901234567", "status": "PAUSED" },
    { "id": "120215678901234568", "budget": 10000 }
  ]
}

Authorizations

Authorization

string

header

required

JWT da plataforma ou API key mtk_live_... enviada no header Authorization

Path Parameters

connection_id

string

required

ID da conexão no Metrito (64a1b2c3d4e5f6a7b8c9d0e1) ou ID da conta de anúncios na plataforma (act_123456789 para Meta Ads).

Example:

"64a1b2c3d4e5f6a7b8c9d0e1"

Body

application/json

type

enum<string>

required

Tipo do objeto a ser atualizado.

Available options:

campaign,

adset,

ad

Example:

"campaign"

updates

(Alterar status · object | Alterar orçamento · object)[]

required

Lista de objetos a atualizar. Cada item deve conter id e exatamente um de status ou budget.

Minimum array length: 1

Alterar status
Alterar orçamento

Show child attributes

Response

Todas as atualizações foram aplicadas com sucesso.

success

boolean

True only if every update in the batch succeeded.

summary

object

Show child attributes

results

object[]

Show child attributes

Visão Geral

Plataforma

API de Dados

API de Rastreamento

Atualizar Objetos de Anúncios

Identificando a conexão

Tipos de objeto suportados

Operações por objeto

Misturar operações em uma chamada

Exemplos de uso

Authorizations

Path Parameters

Body

Response

​Identificando a conexão

​Tipos de objeto suportados

​Operações por objeto

​Misturar operações em uma chamada

​Exemplos de uso

Authorizations

Path Parameters

Body

Response

Identificando a conexão

Tipos de objeto suportados

Operações por objeto

Misturar operações em uma chamada

Exemplos de uso