Todos os produtos
Search
Central de documentação

ApsaraVideo Live:CheckLiveMessageUsersInGroup

Última atualização: Jun 30, 2026

Verifica se um usuário está em um grupo de mensagens interativas.

Descrição da operação

Antes de chamar esta operação, certifique-se de ter chamado a operação CreateLiveMessageGroup para criar um grupo de mensagens interativas.

Limite de QPS

Você pode chamar esta operação até 50 vezes por segundo por conta. As solicitações que excederem esse limite serão descartadas e você enfrentará interrupções no serviço. Recomendamos que leve em conta esse limite ao chamar esta operação.

Depuração

Você pode executar esta interface diretamente no OpenAPI Explorer, sem a necessidade de calcular assinaturas. Após a execução bem-sucedida, o OpenAPI Explorer pode gerar automaticamente exemplos de código do SDK.

Informações de autorização

A tabela a seguir mostra as informações de autorização correspondentes à API. As informações de autorização podem ser usadas no elemento de política Action para conceder as permissões de chamada desta operação de API a um usuário ou função RAM. Descrição:

  • Operação: o valor que você pode usar no elemento Action para especificar a operação em um recurso.
  • Nível de acesso: o nível de acesso de cada operação. Os níveis são leitura, escrita e lista.
  • Tipo de recurso: o tipo de recurso no qual você pode autorizar o usuário ou a função RAM a realizar a operação. Observe os seguintes itens:
    • Para tipos de recursos obrigatórios, indique com o prefixo * .
    • Se as permissões não puderem ser concedidas no nível de recurso, All Resources será usado na coluna Tipo de recurso da operação.
  • Chave de condição: a chave de condição definida pelo serviço de nuvem.
  • Operação associada: outras operações para as quais o usuário ou a função RAM deve ter permissões para concluir a operação. Para concluir a operação, o usuário ou a função RAM deve ter permissões para executar as operações associadas.
OperaçãoNível de acessoTipo de recursoChave de condiçãoOperação associada
live:CheckLiveMessageUsersInGroupnone
*Rtc
acs:live::{#accountId}:rtc/{#AppId}
    none
none

Parâmetros de solicitação

ParâmetroTipoObrigatórioDescriçãoExemplo
AppIdstringSim

O ID do aplicativo.

demo
GroupIdstringSim

O ID do grupo.

grouptest
UserIdsarraySim

A lista de usuários que você deseja consultar.

stringSim

O ID do usuário. Separe vários IDs de usuário com vírgulas (,). O número de usuários a consultar em cada chamada pode variar de 1 a 10.

uid
DataCenterstringNão

O data center. Deve ser o mesmo data center especificado ao chamar a operação CreateLiveMessageApp para criar o aplicativo de mensagens interativas. Valores válidos: cn-shanghai e ap-southeast-1 (Singapura).

cn-shanghai

Parâmetros de resposta

ParâmetroTipoDescriçãoExemplo
object
RequestIdstring

O ID da solicitação.

F1F68D81-1543-1FE4-B56E-82200DD2****
Usersarray<object>

A lista de usuários consultados.

usersobject
UserIdstring

O ID do usuário.

uid1
Onlineboolean

Indica se o usuário está no grupo.

false

Exemplos

Exemplos de respostas bem-sucedidas

JSON formato

{
  "RequestId": "F1F68D81-1543-1FE4-B56E-82200DD2****",
  "Users": [
    {
      "UserId": "uid1",
      "Online": false
    }
  ]
}

Códigos de erro

Código de status HTTPCódigo de erroMensagem de erroDescrição
400InputInvalid%s.Parâmetros de entrada inválidos
403NoAuth%s.Sem permissão
404ResourceNotExist%s.O recurso solicitado não existe. Verifique e tente novamente.
500ServerError%s.Erro desconhecido. Tente novamente mais tarde ou abra um ticket para consulta.

Para obter uma lista de códigos de erro, visite os Códigos de erro do serviço.

Histórico de alterações

Data da alteraçãoResumo das alteraçõesOperação
Sem histórico de alterações