Tags de ativo de criativo

Você pode atribuir tags aos seus ativos de criativos: imagens e vídeos.

Adicionar tags de ativo de criativo

Você pode adicionar uma tag de ativo de criativo a um criativo fazendo uma solicitação POST para os pontos de extremidade {business-image-id}/creative_asset_tags ou {business-video-id}/creative_asset_tags. Inclua os parâmetros business-id e tag_name na sua chamada.

Para imagens

Exemplo de solicitação:

curl -i -X POST \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_IMAGE_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
"success": true
}

Para vídeos

Exemplo de solicitação:

curl -i -X POST \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_VIDEO_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
"success": true
}

Remover tag de ativo de criativo

Remova uma tag de uma imagem e um vídeo de negócios enviando uma solicitação DELETE para os pontos de extremidade {business-image-id}/creative_asset_tags ou {business-video-id}/creative_asset_tags. Inclua os parâmetros business-id e tag_name.

Para imagens

Exemplo de solicitação:

curl -i -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_IMAGE_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
"success": true
}

Para vídeos

Exemplo de solicitação:

curl -i -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_VIDEO_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
"success": true
}

Obter tags de ativo de criativo para um ativo

Para ver tags associadas a uma imagem e um vídeo específicos, envie uma solicitação GET para as bordas {business_image_id}/creative_asset_tags ou {business_video_id}/creative_asset_tags. Especifique business_id={business_id} na sua chamada.

Para imagens

Exemplo de solicitação:

curl -i -X GET \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_IMAGE_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
  "data": [
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    }
  ]
}

Para vídeos

Exemplo de solicitação:

curl -i -X GET \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_VIDEO_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
  "data": [
    {
      "name": "<TAG_NAME>"
    }
  ]
}

Obter tags de ativo de criativo para uma empresa

Para ver todas as tags de ativos de criativos existentes na empresa, envie uma solicitação GET para a borda {business_id}/creative_asset_tags.

Exemplo de solicitação:

curl -i -X GET \
"https://graph.facebook.com/v5.0/<BUSINESS_ID>/creative_asset_tags?access_token=<ACCESS_TOKEN>"

Exemplo de uma resposta bem-sucedida:

{
  "data": [
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    }
  ]
}

Pontos de extremidade

POST

Ponto de extremidadeDescrição

{business_image_id}/creative_asset_tags

Adicione uma tag de ativo de criativo a uma imagem.

{business_video_id}/creative_asset_tags

Adicione uma tag de ativo de criativo a um vídeo.

READ

Ponto de extremidadeDescrição

{business_image_id}/creative_asset_tags

Obtenha todas as tags de ativo de criativo associadas a uma imagem.

{business_video_id}/creative_asset_tags

Obtenha todas as tags de ativo de criativo associadas a um vídeo.

{business_id}/creative_asset_tags

Obtenha todas as tags de ativo de criativo de uma empresa específica.

DELETE

Ponto de extremidadeDescrição

{business_image_id}/creative_asset_tags

Remova uma tag de ativo de criativo de uma imagem.

{business_video_id}/creative_asset_tags

Remova uma tag de ativo de criativo de um vídeo.