Google Chat alanı etkinliğiyle ilgili ayrıntıları alma

Bu kılavuzda, Google Chat alanındaki bir etkinlikle ilgili ayrıntıları almak için Google Chat API'nin SpaceEvent kaynağındaki get() yönteminin nasıl kullanılacağı açıklanmaktadır.

SpaceEvent kaynağı, bir alanda veya alt kaynaklarında (ör. mesajlar, tepkiler ve üyelikler) yapılan bir değişikliği temsil eder. Desteklenen etkinlik türleri hakkında bilgi edinmek için SpaceEvent kaynağı referans belgelerinin eventType alanını inceleyin.

Etkinlik isteğinde bulunmadan 28 gün öncesine kadar etkinlik isteğinde bulunabilirsiniz. Etkinlik, değişen kaynağın en son sürümünü içerir. Örneğin, yeni bir mesajla ilgili etkinlik isteğinde bulunursanız ancak mesaj daha sonra güncellenirse sunucu, etkinlik yükü içinde güncellenmiş Message kaynağını döndürür.

Bu yöntemi çağırmak için kullanıcı kimlik doğrulamasını kullanmanız gerekir. Bir etkinliği almak için kimliği doğrulanmış kullanıcının, etkinliğin gerçekleştiği alanın üyesi olması gerekir.

Ön koşullar

Node.js

Alan etkinlikleriyle ilgili ayrıntıları alma

Google Chat'te bir alan etkinliğiyle ilgili ayrıntıları almak için isteğinizde aşağıdakileri iletin:

  • İsteğinizde etkinlik türünü destekleyen bir yetkilendirme kapsamı belirtin. En iyi uygulama olarak, uygulamanızın çalışmaya devam etmesine izin veren en kısıtlayıcı kapsamı seçin.
  • Almak için alan etkinliğinin name değerini ileterek GetSpaceEvent() yöntemini çağırın.

Aşağıdaki örnek bir alan etkinliği alır:

Node.js

chat/client-libraries/cloud/get-space-event-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME'
  };

  // Make the request
  const response = await chatClient.getSpaceEvent(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Bu örneği çalıştırmak için aşağıdakileri değiştirin:

  • SCOPE_NAME: etkinlik türüne göre bir yetkilendirme kapsamı. Örneğin, yeni bir üyelikle ilgili bir alan etkinliği alıyorsanız https://www.googleapis.com/auth/chat.memberships.readonly olarak biçimlendirilmiş chat.memberships.readonly kapsamını kullanın. Etkinlik türünü ListSpaceEvents() yönteminden alabilirsiniz. Bu yöntemin nasıl kullanılacağını öğrenmek için Bir alandaki etkinlikleri listeleme başlıklı makaleyi inceleyin.
  • SPACE_NAME: Alanın name bilgilerinden alınan kimlik. Kimliği, ListSpaces() yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.
  • SPACE_EVENT_NAME: Alan etkinliğinin name kimliği. Kimliği ListSpaceEvents() yönteminden alabilirsiniz. Bu yöntemin nasıl kullanılacağını öğrenmek için Bir alandaki etkinlikleri listeleme başlıklı makaleyi inceleyin.

Chat API, etkinlikle ilgili ayrıntıları içeren bir SpaceEvent örneği döndürür.