Colaboradores

Representa una lista de usuarios que se añaden como colaboradores en un objeto de contenido multimedia de Instagram.

Creación

Esta operación no es compatible.

Lectura

Obtén una lista de usuarios de Instagram como colaboradores y el estado de su invitación en un objeto de contenido multimedia de Instagram.

GET /{ig-media-id}

Limitaciones

Se puede añadir un máximo de tres cuentas de Instagram como colaboradores.
En esta respuesta, solo se devolverán los usuarios de Instagram que hayan activado el etiquetado de colaboradores.
El etiquetado de colaboradores es compatible con las imágenes del feed, los reels y las secuencias, pero no es compatible con las historias.

Requisitos

Tipo Descripción

Tipo	Descripción
Identificadores de acceso	Usuario: el usuario debe haber creado el objeto de contenido multimedia de Instagram.
Permisos	`instagram_basic` `pages_read_engagement` `pages_show_list` Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitas uno de los permisos siguientes: `ads_management` `business_management`

Identificadores de acceso

Usuario: el usuario debe haber creado el objeto de contenido multimedia de Instagram.

Permisos

instagram_basic
pages_read_engagement
pages_show_list

Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitas uno de los permisos siguientes:

ads_management
business_management

Sintaxis de la solicitud

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

Ejemplo de respuesta

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

Parámetros de ruta

Marcador de posición	Valor
`{api-version}`	Versión de la API.
`{ig-user-id}`	Obligatorio. Identificador del usuario de Instagram.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Identificador de acceso del usuario de la aplicación.

Campos de respuesta

Nombre del campo Descripción

Nombre del campo	Descripción
`id`	Identificador específico de la aplicación de la cuenta de Instagram del posible colaborador.
`invite_status`	Estado de la invitación que se ha enviado al posible colaborador. Puede ser uno de los siguientes: `Accepted` `Declined` `Pending`
`username`	Nombre de usuario del perfil de Instagram del posible colaborador.

id

Identificador específico de la aplicación de la cuenta de Instagram del posible colaborador.

invite_status

Estado de la invitación que se ha enviado al posible colaborador. Puede ser uno de los siguientes:

Accepted
Declined
Pending

username

Nombre de usuario del perfil de Instagram del posible colaborador.

Actualización

Esta operación no es compatible.

Eliminar

Esta operación no es compatible.