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

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

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

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

Bu yöntemi çağırmak için kullanıcı kimlik doğrulaması 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

Bir alan etkinliği hakkında ayrıntılı bilgi edinme

Google Chat'teki bir alan etkinliği hakkında ayrıntılı bilgi edinmek 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ışmasına izin veren en kısıtlı kapsamı seçin.
  • Alınacak alan etkinliğinin name değerini ileterek GetSpaceEvent() yöntemini çağırın.

Aşağıdaki örnekte bir alan etkinliği alınmaktadı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 dayalı bir yetkilendirme kapsamı. Örneğin, yeni bir üyelikle ilgili bir alan etkinliği alıyorsanız chat.memberships.readonly kapsamını https://www.googleapis.com/auth/chat.memberships.readonly biçiminde kullanın. Etkinlik türünü ListSpaceEvents() yönteminden alabilirsiniz. Bu yöntemi nasıl kullanacağınızı öğrenmek için Bir alandaki etkinlikleri listeleme başlıklı makaleyi inceleyin.
  • SPACE_NAME: Alanın name kimliği. 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öntemi nasıl kullanacağınızı öğrenmek için Bir alandaki etkinlikleri listeleme başlıklı makaleyi inceleyin.

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