Obter todas as solicitações de serviço de um cliente

Artigo
06/04/2024

Aplica-se a: Partner Center | Partner Center para o Microsoft Cloud for US Government

Obtém todas as solicitações de serviço de um cliente.

No Partner Center, essa operação pode ser executada selecionando primeiro um cliente. Em seguida, selecione Gerenciamento de serviços na barra lateral esquerda. As solicitações de serviço do cliente são exibidas em Tíquetes de suporte.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.
Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá pesquisá-la no Partner Center selecionando o workspace Clientes , o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).

C#

Para exibir uma lista de todas as solicitações de serviço de um cliente, use sua coleção IAggregatePartner.Customers e chame o método ById(). Em seguida, chame a propriedade ServiceRequests, seguida pelos métodos Get() ou GetAsync().

// IAggregatePartner partnerOperations;
// string customerId as string;

ResourceCollection<ServiceRequest> serviceRequests = partnerOperations.Customers.ById(customerId).ServiceRequests.Get();

Exemplo: aplicativo de teste do console. Projeto: Classe PartnerCenterSDK.FeaturesSamples : CustomerManagedServices.cs

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL}/v1/customers/{customer-tenant-id}/servicerequests HTTP/1.1

Parâmetro do URI

Use o parâmetro de consulta a seguir para obter todas as solicitações de serviço para o cliente.

Nome	Type	Obrigatório	Descrição
customer-tenant-id	guid	Y	Um GUID correspondente ao cliente.

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/servicerequests HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 53d5d48c-9693-46b6-8071-2eed07797d6c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Resposta REST

Se tiver êxito, este método retornará uma coleção de recursos de Solicitação de Serviço no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 742
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 53d5d48c-9693-46b6-8071-2eed07797d6c
Date: Tue, 24 Nov 2015 07:19:21 GMT

{
    "totalCount": 1,
    "items": [{
        "title": "Test",
        "severity": 0,
        "id": "615112491169010",
        "status": 1,
        "primaryContact": {
            "lastName": "LastName",
            "firstName": "FirstName"
        },
        "createdDate": "2015-11-24T01:07:00.863",
        "lastModifiedDate": "2015-11-24T01:17:10.61",
        "lastClosedDate": "0001-01-01T00:00:00",
        "attributes": {
            "objectType": "ServiceRequest"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

Compartilhar via