Gestire il ciclo di vita dei canali privati in Microsoft TeamsManage the life cycle of private channels in Microsoft Teams

Ecco le indicazioni necessarie per gestire l'uso dell'API Graph per gestire Teams canali privati dell'organizzazione.Here you'll find the guidance you need to manage use the Graph API to manage Teams private channels in your organization.

Specificare se i membri del team possono creare canali privatiSet whether team members can create private channels

Gli amministratori possono usare l’API Graph per controllare se i membri possono creare canali privati in specifici team.As an admin, you can use Graph API to control whether members can create private channels in specific teams. Di seguito viene riportato un esempio.Here's an example.

PATCH /teams/<team_id>
{"memberSettings": 
  {
    "allowCreatePrivateChannels": false
  }
}

Creare un canale privato per conto del proprietario del teamCreate a private channel on behalf of a team owner

Gli amministratori possono usare l'API Graph per creare un canale privato per conto di un proprietario del team.As an admin, you can use the Graph API to create a private channel on behalf of a team owner. Ad esempio, questa operazione potrebbe essere effettuata se l'organizzazione vuole centralizzare la creazione di canali privati.For example, you may want to do this if your organization wants to centralize creation of private channels.

POST /teams/{id}/channels
{ "membershipType": "Private",
  "displayName": "<Channel_Name>",
  "members":[{    
           "@odata.type":"#microsoft.graph.aadUserConversationMember",
           "user@odata.bind":"https://graph.microsoft.com/beta/users('<user_id>')",
           "roles":["owner"]
            }]

Ottenere un elenco di tutti i messaggi del canale privatoGet a list of all private channel messages

Potrebbe essere necessario ottenere un elenco di tutti i messaggi e le risposte pubblicate in un canale privato a scopo di archiviazione e controllo.You may want to get a list of all messages and replies posted in a private channel for archiving and auditing purposes. Di seguito viene illustrato come usare l'API di Graph per eseguire questa operazione.Here's how to use Graph API to do this.

GET /teams/{id}/channels/{id}/messages
GET /teams/{id}/channels/{id}/messages/{id}/replies/{id}

Trovare gli URL di SharePoint per tutti i canali privati di un teamFind SharePoint URLs for all private channels in a team

Sia che si stia cercando di eseguire l'eDiscovery o la conservazione legale su file in un canale privato, oppure si stia cercando di creare un'app personalizzata che metta i file in canali privati specifici, è necessario un modo per effettuare una query delle raccolte siti univoci di SharePoint create per ciascuno canale privato.Whether you're looking to perform eDiscovery or legal hold on files in a private channel or looking to build a custom app that places files in specific private channels, you'll want a way to query the unique SharePoint site collections that are created for each private channel.

Gli amministratori possono usare i comandi api Graph per eseguire query su questi URL.As an admin, you can use Graph APIs commands to query these URLs.

È possibile provare questi comandi con Graph explorer.You can try these commands through Graph Explorer.

  1. Usare la procedura seguente per ottenere l'elenco di ID del canale privato per un determinato team, in cui <group_id> è l'ID del gruppo del team.Use the following to get the list of private channel IDs for a given team, where <group_id> is the group ID of the team. Questo sarà necessario nelle chiamate successive.You'll need this in subsequent calls. È possibile trovare facilmente l'ID del gruppo nel collegamento al team.(You can easily find the group ID in the link to the team).

    RichiestaRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels?$filter=membershipType eq 'private'
    

    RispostaResponse

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length:
    
    {
      "value": [
        {
          "description": "description-value",
          "displayName": "display-name-value",
          "id": "channel_id",
          "membershipType": "membership-type-value",
          "isFavoriteByDefault": false,
          "webUrl": "webUrl-value",
          "email": "email-value"
        }
      ]
    }
    
  2. Per ogni canale privato per il quale si vuole ottenere l'URL di SharePoint, eseguire la richiesta seguente, in cui <channel_id> è l'ID del canale.For each private channel which you want to get the SharePoint URL, make the following request, where <channel_id> is the channel ID.

    RichiestaRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/filesFolder
    

    RispostaResponse

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length:
    
    {
      "value": [
        {
          "description": "description-value",
          "displayName": "display-name-value",
          "id": "channel_id",
          "membershipType": "membership-type-value",
          "isFavoriteByDefault": false,
          "webUrl": "webUrl-value",
          "email": "email-value"
        }
      ]
    }
    

Elencare e aggiornare i ruoli di proprietari e membri in un canale privatoList and update roles of owners and members in a private channel

È possibile elencare i proprietari e i membri di un canale privato per decidere se sia necessario alzare di livello determinati membri del canale privato e impostarli come proprietari.You may want to list out the owners and members of a private channel to decide whether you need to promote certain members of the private channel to an owner. Questo può verificarsi se sono presenti proprietari di canali privati che hanno lasciato l'organizzazione e il canale privato richiede l'assistenza da parte dell'amministratore per rivendicarne la proprietà.This can happen when you have owners of private channels who have left the organization and the private channel requires admin help to claim ownership of the channel.

L'amministratore può usare l'API Graph per eseguire queste azioni.As an admin, you can use the Graph API to perform these actions.

È possibile provare questi comandi con Graph explorer.You can try these commands through Graph Explorer.

  1. Usare quanto segue, in cui<group_id> è l'ID del gruppo del team e <channel_id> è l’ID del canale.Use the following, where <group_id> is the group ID of the team and <channel_id> is the channel ID.

    RichiestaRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/members
    

    RispostaResponse

    HTTP/1.1 200 OK Content-type: application/json
    Content-length: 
    {
          "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams({group_id}')/channels('{channel_id}')/members",
          "@odata.count": 2,
          "value": [
              {
                  "@odata.type": "#microsoft.graph.aadUserConversationMember",
                  "id": "id-value",
                  "roles": [],
                  "displayName": "display-name-value",
                  "userId": "userId-value",
                  "email": "email-value"
              },
              {
                  "@odata.type": "#microsoft.graph.aadUserConversationMember",
              "id": "id-value",
              "roles": ["owner"],
              "displayName": "display-name-value",
              "userId": "userId-value",
              "email": "email-value"
              }
          ]
    }
    
  2. Usare quanto segue per alzare di livello un membro a proprietario, in cui <group_id>, <channel_id>, e <id> vengono restituiti dalla chiamata precedente.Use the following to promote the member to an owner, where <group_id>, <channel_id>, and <id> are returned from the previous call. Si noti che <id> e <userId> restituiti dalla chiamata precedente non sono uguali e non sono intercambiabili.Note that <id> and <userId> returned from the previous call aren't the same and aren't interchangeable. Assicurarsi di usare <id>.Make sure you use <id>.

    RichiestaRequest

    PATCH 
    https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/members/<id>
    
    {
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"]
    }
    

    RispostaResponse

    HTTP/1.1 200 OK
    Content-type: application/json
    
    {
      "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('{group_id}')/channels('{channel_id}')/members/$entity",
      "@odata.type": "#microsoft.graph.aadUserConversationMember",
      "id": "id-value",
      "roles": ["owner"],
      "displayName": "display-name-value",
      "userId": "userId-value",
      "email": "email-value"
     }
    

Usare l'API Microsoft Graph per lavorare con TeamsUse the Microsoft Graph API to work with Teams

Elencare canaliList channels

Creare canaliCreate channel

Aggiungere membri al canaleAdd member to channel

Aggiornare membri nel canaleUpdate member in channel

Rimuovere membri dal canaleRemove member from channel