Todos os produtos
Search
Central de documentação

:DescribeCustomEventCount

Última atualização: Jun 26, 2026

Consulta o número de ocorrências de um evento personalizado em um período especificado.

Nota

Esta operação contabiliza as ocorrências de eventos personalizados para cada serviço.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDescribeCustomEventCount

Operação a executar. Defina o valor como DescribeCustomEventCount.

NameStringNãoBABEL_BUY

Nome do evento personalizado.

EventIdStringNão123

ID do evento personalizado.

GroupIdStringNão12345

ID do grupo de aplicativos.

SearchKeywordsStringNãocms

Palavras-chave presentes no conteúdo do evento personalizado a consultar. Use operadores lógicos entre as palavras-chave.

  • Para consultar eventos com conteúdo contendo "a" e "b", defina o valor como "a and b".
  • Para consultar eventos com conteúdo contendo "a" ou "b", defina o valor como "a or b".
StartTimeStringNão1552209685596

Início do intervalo de tempo a consultar.

Valor expresso como timestamp UNIX, representando milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC (epoch).

EndTimeStringNão1552220485596

Fim do intervalo de tempo a consultar.

Valor expresso como timestamp UNIX, representando milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC (epoch).

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdString60912C8D-B340-4253-ADE7-61ACDFD25CFC

ID da solicitação.

SuccessBooleantrue

Indica se a chamada foi bem-sucedida. O valor true indica sucesso; false indica falha.

CodeString200

Código de status HTTP.

Nota O código de status 200 indica que a chamada foi bem-sucedida.
CustomEventCountsArrayN/A

Detalhes do evento personalizado.

CustomEventCountN/AN/AN/A
NameStringBABEL_BUY

Nome do evento personalizado.

NumInteger20

Número de ocorrências do evento personalizado no período especificado.

TimeLong1552267615000

Momento da ocorrência do evento personalizado.

Valor expresso como timestamp UNIX, representando milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC (epoch).

MessageStringsuccess

Mensagem retornada. Em caso de sucesso, retorna o valor success. Se houver falha, retorna uma mensagem de erro.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=DescribeCustomEventCount
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

<DescribeCustomEventCount>
          <CustomEventCounts>
                <CustomEventCount>
                      <Name>BABEL_BUY</Name>
                      <Time>1552267615000</Time>
                      <Num>20</Num>
                </CustomEventCount>
          </CustomEventCounts>
          <Message>success</Message>
          <RequestId>38D3C270-6799-4461-AA55-7975352140C1</RequestId>
          <Code>200</Code>
          <Success>true</Success>
</DescribeCustomEventCount>

Formato JSON

{
    "CustomEventCounts": {
        "CustomEventCount": 
        {
            "Name":"BABEL_BUY",
            "Time":1552267615000,
            "Num":"20"
        }
    },
    "Message": "success",
    "RequestId": "38D3C270-6799-4461-AA55-7975352140C1",
    "Code": "200",
    "Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.