Compartilhar via

Criar qna

  • Artigo

Espaço de nomes: microsoft.graph.search

Crie um novo objeto qna .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

Solicitação HTTP

POST /search/qnas

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto qna .

A tabela seguinte mostra as propriedades que estão disponíveis quando cria uma qna.

Propriedade Tipo Descrição
availabilityEndDateTime DateTimeOffset Data e hora em que o FAQ deixa de aparecer como resultado da pesquisa. Defina como null para sempre disponível. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
availabilityStartDateTime DateTimeOffset Data e hora em que o FAQ começa a aparecer como um resultado de pesquisa. Defina como null para sempre disponível. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
description Cadeia de caracteres Resposta apresentada nos resultados da pesquisa. Herdado de searchAnswer.
displayName Cadeia de caracteres Pergunta que é apresentada nos resultados da pesquisa. Herdado de searchAnswer.
groupIds Coleção de cadeias de caracteres A lista de grupos de segurança que conseguem ver esta FAQ.
palavras-chave microsoft.graph.search.answerKeyword As palavras-chave que acionam esta FAQ são apresentadas nos resultados da pesquisa.
languageTags String collection Uma lista de nomes de idiomas geograficamente específicos nos quais esta FAQ pode ser visualizada. Cada valor de etiqueta de idioma segue o padrão {language}-{region}. Por exemplo, é inglês, en-us conforme utilizado nos Estados Unidos. Para obter a lista de valores possíveis, veja Etiquetas de idioma suportadas.
plataformas coleção microsoft.graph.devicePlatformType Lista de dispositivos e sistemas operativos que conseguem ver este FAQ. Os valores possíveis são: android, androidForWork, ios, macOS, windowsPhone81, windowsPhone81AndLater, windows10AndLater, androidWorkProfile, unknown, androidASOP, androidMobileApplicationManagement, iOSMobileApplicationManagement e unknownFutureValue.
state microsoft.graph.search.answerState Estado da FAQ. Os valores possíveis são: published, draft, excluded, unknownFutureValue.
targetedVariations coleção microsoft.graph.search.answerVariant Variações de um FAQ para diferentes países ou dispositivos. Utilize quando precisar de mostrar conteúdos diferentes aos utilizadores com base no respetivo dispositivo, país/região ou ambos. As definições de data e grupo aplicam-se a todas as variações.
webUrl String A ligação do URL para o FAQ. Quando os utilizadores selecionam esta FAQ nos resultados da pesquisa, são direcionados para o URL especificado. Herdado de searchAnswer.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta com o ID da pergunta e resposta criada.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/search/qnas
Content-Type: application/json

{
  "displayName": "Global Country Holidays",
  "webUrl": "http://www.contoso.com/",
  "description": "The dates that Contoso offices will be closed to observe holidays. These dates may differ from the actual date of the holiday in cases where the holiday falls on a weekend.    <table>    <thead>    <tr>    <td><strong>2021 Dates</strong></td>    <td><strong>Holiday</strong></td>    </tr>    </thead>    <tbody>    <tr>        <td>January 1, 2021</td>        <td>New Year's Day</td>    </tr>        <tr>        <td>January 18, 2021</td>        <td>Martin Luther King Day</td>    </tr>        <tr>        <td>February 15, 2021</td>        <td>Presidents Day</td>    </tr>        <tr>        <td>May 31, 2021</td>        <td>Memorial Day</td>    </tr>        <tr>        <td>July 5, 2021</td>        <td>Independence Day</td>    </tr>        <tr>        <td>September 6, 2021</td>        <td>Labor Day</td>    </tr>        <tr>        <td>November 25, 2021 - November 26, 2021</td>        <td>Thanksgiving Day and Day after Thanksgiving</td>    </tr>    <tr>        <td>December 23, 2021 - December 24, 2021</td>        <td>Christmas Eve and Christmas Day</td>    </tr>    </tbody>    </table>",
  "keywords":  {
    "keywords": ["new years day", "martin luther king day", "presidents day", "memorial day", "independence day", "labor day", "thanksgiving", "christmas"],
    "reservedKeywords": ["holidays", "paid days off"],
    "matchSimilarKeywords": true
  },
  "availabilityStartDateTime": "2020-09-21T20:01:37Z",
  "availabilityEndDateTime": "2021-12-31T20:01:37Z",
  "languageTags": ["en-us"],
  "platforms": ["ios"],
  "state": "published"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created
Location: /733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}