İçeriğe geç
Tüm araçlar

teams_search_messages

Microsoft Teams · macOS · Windows

Etki: okuma. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Bir Microsoft 365 hesabının Microsoft Teams sohbet ve kanal iletilerinde Microsoft Search ile arama yapar: metne göre ve isteğe bağlı olarak gönderen ve tarih aralığına göre. Sohbeti bilmeden bir konunun nerede konuşulduğunu bulmak için kullanın. Sonuçlar Microsoft'un alaka sırasıyla gelir (en yeniden başlayarak değil) ve body, iletinin tamamı değil, eşleşmenin çevresinden bir parçadır; geri kalanı için sohbeti teams_read_chat_messages ile okuyun. Aramanın en fazla 4 sayfasından en fazla 100 sonuç döndürür. Okuma kesilirse (bu sınır nedeniyle ya da çağrının süresi dolduğu için) yanıtta truncated: true bulunur. Bir iş veya okul Microsoft 365 hesabının connect_m365_account ile bağlanmış olması gerekir (kişisel Microsoft hesaplarında Teams okuma yoktur). Hiçbir Microsoft 365 hesabı bağlı değilse bunun yerine bu Mac'teki Teams uygulamasının yerel önbelleğini okur (Full Disk Access gerektirir, saatler veya günlerce geride olabilir); yanıttaki source hangisinin yanıt verdiğini belirtir (graph veya local_cache).

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

İngilizce kanonik teknik şema — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "from_sender": {
      "description": "Only messages from this sender (name or email; optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

teams_search_messages için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "limit": 5,
  "query": "launch checklist"
}

Windows

Amaç

Tüm konuşmaları aynı anda kapsayarak Microsoft Teams sohbet ve doğrudan ileti geçmişinizde metne, gönderen adına ve/veya tarih aralığına göre arama yapar. Bir konunun hangi sohbette konuşulduğunu bilmeden Teams içinde bulmak için bunu kullanın. Eşleşen iletileri (en alakalı önce), her biri bir parça ve geldiği sohbetle birlikte döndürür. Aramanın en fazla 4 sayfasından en fazla 100 sonuç döndürür. Okuma kesilirse (bu sınır nedeniyle ya da çağrının süresi dolduğu için) yanıtta truncated: true bulunur.

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

İngilizce kanonik teknik şema — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "from_sender": {
      "description": "Filter to a sender by name (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in messages",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Belge örneği

teams_search_messages için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "limit": 5,
  "query": "launch checklist"
}