Google Workspace aboneliği oluşturma

Bu sayfada, Google Workspace Events API'yi kullanarak bir Bir Google Workspace kaynağına aboneliğinizi iptal edin. Google Workspace aboneliği uygulamanızın Google Workspace etkinlikleri hakkında bilgi almasını sağlar. Bir Google Workspace kaynağında yapılan değişiklikleri temsil eder. Hakkında bilgi edinmek için Google Workspace Events API'nin desteklediği kaynaklar ve etkinlik türleri hakkında daha fazla bilgi Google Workspace Events API'ye genel bakış başlıklı makaleyi inceleyin.

Bu sayfada, Google Workspace hesabı oluşturmak için aşağıdaki adımlar yer almaktadır abonelik:

  1. Ortamınızı ayarlayın.
  2. Google Cloud Pub/Sub konusu oluşturma ve bu konuya abone olma. Bu konuyu şu şekilde kullanıyorsunuz: Google Workspace etkinliklerini almak için bir uç nokta.
  3. Google Workspace Events API'yi create() çağırın yöntemini Subscription gösterir.
  4. Pub/Sub'ın eksiksiz olduğundan emin olmak için Google Workspace aboneliğinizi test edin konu, abone olduğunuz etkinlikleri alır.
  5. Dilerseniz etkinlikleri uygulamanızın uç noktasına nasıl aktaracağınızı yapılandırabilirsiniz. Uygulamanızın etkinliği işleyebilmesi ve gerekiyorsa işlem yapabilmesi.

Ön koşullar

Apps Komut Dosyası

  • Bir Google Cloud projesi tercih edebilirsiniz. Chat abonelikleri için: Cloud projenizde Chat API'yi etkinleştirin ve App name (Uygulama adı), Avatar URL'si (Avatar URL'si) ve Description (Açıklama) ayarlarını yapılandırın. alanları. Ayrıntılar için bkz. Google Chat uygulaması oluşturun.
  • Şunlar için yapılandırılmış OAuth izin ekranıyla kullanıcı kimlik doğrulaması gerektirir: görebilirsiniz. İzin ekranını yapılandırdığınızda tüm etkinlik türlerini destekler. İzni yapılandırmak için: ve gerekli kapsamları belirlemek için Kapsamları seçin.
  • Bir Apps Komut Dosyası projesi:
    • tarafından otomatik olarak oluşturulan varsayılan proje yerine Google Cloud projenizi kullanın Apps Komut Dosyası.
    • OAuth izin ekranını yapılandırmak üzere eklediğiniz tüm kapsamlar için kapsamlarını Apps Komut Dosyası projenizdeki appsscript.json dosyasına ekleyebilirsiniz. Örneğin:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Etkinleştir Google Workspace Events gelişmiş hizmetini kullanabilirsiniz.

Python

  • Python 3.6 veya sonraki sürümler
  • pip paket yönetim aracı
  • Python için en yeni Google istemci kitaplıkları. Bunları yüklemek veya güncellemek için aşağıdaki komutu çalıştırın komutunu çalıştırın:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
    .
  • Bir Google Cloud projesi tercih edebilirsiniz. Chat abonelikleri için: Cloud projenizde Chat API'yi etkinleştirin ve App name (Uygulama adı), Avatar URL'si (Avatar URL'si) ve Description (Açıklama) ayarlarını yapılandırın. alanları. Ayrıntılar için bkz. Google Chat uygulaması oluşturun.
  • Şunlar için yapılandırılmış OAuth izin ekranıyla kullanıcı kimlik doğrulaması gerektirir: görebilirsiniz. İzin ekranını yapılandırdığınızda tüm etkinlik türlerini destekler. İzni yapılandırmak için: ve gerekli kapsamları belirlemek için Kapsamları seçin.

Ortamınızı ayarlama

Aşağıdaki bölümde, oluşturmadan önce ortamınızı nasıl ayarlayacağınız açıklanmaktadır. Google Workspace aboneliği

Google Workspace Events API ve Google Cloud Pub/Sub API'yi etkinleştirme

Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.

Google Cloud Console

Google Cloud konsolunda uygulamanızın Google Cloud projesini açın ve Google Workspace Events API ve Pub/Sub API:

API'leri etkinleştirme

gcloud

  1. Çalışma dizininizde Google Hesabınızda oturum açın:

    gcloud auth login
    
  2. Projenizi, uygulamanızın Cloud projesine ayarlayın:

    gcloud config set project PROJECT_ID
    

    PROJECT_ID değerini şununla değiştirin: Uygulamanızın Cloud projesinin proje kimliği.

  3. Google Workspace Events API ve Google Cloud Pub/Sub'ı etkinleştirme API:

    gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com
    

OAuth istemci kimliği kimlik bilgileri oluşturma

OAuth istemci kimliğinin nasıl oluşturulacağına ilişkin talimatlar için uygulama türünüzü seçin:

Web uygulaması

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > Web uygulaması'nı tıklayın.
  4. Ad alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. Uygulamanızla ilgili yetkili URI'ler ekleyin:
    • İstemci tarafı uygulamalar (JavaScript): Yetkili JavaScript kaynakları altında, URI ekle'yi tıklayın. Ardından, tarayıcı istekleri için kullanılacak bir URI girin. Bu, uygulamanızın OAuth 2.0 sunucusuna API istekleri gönderebileceği alan adlarını tanımlar.
    • Sunucu tarafı uygulamalar (Java, Python ve daha fazlası): Yetkili yönlendirme URI'leri bölümünde URI ekle'yi tıklayın. Ardından, OAuth 2.0 sunucusunun yanıt gönderebileceği bir uç nokta URI'si girin.
  6. Oluştur'u tıklayın. Yeni İstemci Kimliğiniz ve İstemci sırrınızın gösterildiği, OAuth istemcisi oluşturuldu ekranı görüntülenir.

    İstemci kimliğini not edin. İstemci gizli anahtarları web uygulamaları için kullanılmaz.

  7. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi OAuth 2.0 İstemci Kimlikleri altında görünür.

Android

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > Android'i tıklayın.
  4. "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. "Paket adı" bölümünde alanına, AndroidManifest.xml dosyanızdaki paket adını girin.
  6. "SHA-1 sertifika dijital parmak izi"nde alanına, oluşturulan SHA-1 sertifika parmak izinizi girin.
  7. Oluştur'u tıklayın. Yeni İstemci Kimliğinizin gösterildiği OAuth istemcisi oluşturuldu ekranı görünür.
  8. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.

iOS

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > iOS'u tıklayın.
  4. "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. "Paket kimliği"nde alanına, uygulamanın Info.plist dosyasında listelendiği şekilde paket tanımlayıcısını girin.
  6. İsteğe bağlı: Uygulamanız Apple App Store'da görünüyorsa App Store kimliğini girin.
  7. İsteğe bağlı: "Ekip Kimliği"nde alanına, Apple tarafından oluşturulan ve ekibinize atanan 10 karakterlik benzersiz dizeyi girin.
  8. Oluştur'u tıklayın. Yeni İstemci Kimliğiniz ve İstemci sırrınızın gösterildiği, OAuth istemcisi oluşturuldu ekranı görüntülenir.
  9. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.

Chrome uygulaması

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > Chrome uygulaması'nı tıklayın.
  4. "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. "Uygulama Kimliği" bölümünde alanına, uygulamanızın 32 karakterlik benzersiz kimlik dizesini girin. Bu kimlik değerini, uygulamanızın Chrome Web Mağazası URL'sinde ve Chrome Web Mağazası Geliştirici Kontrol Paneli'nde bulabilirsiniz.
  6. Oluştur'u tıklayın. Yeni İstemci Kimliğiniz ve İstemci sırrınızın gösterildiği, OAuth istemcisi oluşturuldu ekranı görüntülenir.
  7. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.

Masaüstü uygulaması

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > Masaüstü uygulaması'nı tıklayın.
  4. Ad alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. Oluştur'u tıklayın. Yeni İstemci Kimliğiniz ve İstemci sırrınızın gösterildiği, OAuth istemcisi oluşturuldu ekranı görüntülenir.
  6. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi OAuth 2.0 İstemci Kimlikleri altında görünür.

TV'ler ve Sınırlı Giriş cihazları

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > TV'ler ve Sınırlı Giriş cihazları.
  4. "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. Oluştur'u tıklayın. Yeni İstemci Kimliğiniz ve İstemci sırrınızın gösterildiği, OAuth istemcisi oluşturuldu ekranı görüntülenir.
  6. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.

Evrensel Windows Platformu (UWP)

  1. Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
  3. Uygulama türü > Evrensel Windows Platformu (UWP) seçeneğini tıklayın.
  4. "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
  5. "Mağaza kimliği"nde alanına uygulamanızın 12 karakterlik benzersiz Microsoft Store kimliği değerini girin. Bu kimliği, uygulamanızın Microsoft Store URL'sinde ve İş Ortağı Merkezi'nde bulabilirsiniz.
  6. Oluştur'u tıklayın. Yeni İstemci Kimliğiniz ve İstemci sırrınızın gösterildiği, OAuth istemcisi oluşturuldu ekranı görüntülenir.
  7. Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.

İstemci gizli anahtarı JSON dosyasını indirme

İstemci gizli anahtarı dosyası, OAuth istemci kimliğinin JSON gösterimidir. uygulamanızın kimlik bilgisi sağlarken başvurabileceği kimlik bilgileri.

  1. Google Cloud konsolunda Menü'ye gidin > API'lar ve Hizmetler > Kimlik bilgileri.

    Kimlik bilgilerine git

  2. OAuth 2.0 Client IDs (OAuth 2.0 İstemci Kimlikleri) bölümünde, oluşturduğunuz istemci kimliğini tıklayın.

  3. JSON'u indir'i tıklayın.

  4. Dosyayı client_secrets.json olarak kaydedin.

Pub/Sub konusu oluşturma ve bu konuya abone olma

Bu bölümde, bir Pub/Sub konusu ve aboneliği oluşturacaksınız konusuna değinmek istiyorum. Pub/Sub konunuz şu işlevi görür: Google Workspace aboneliğinizin aldığı bildirim uç noktası etkinlikler.

Pub/Sub konuları oluşturma ve yönetme hakkında daha fazla bilgi edinmek için Pub/Sub belgeleri ,

Pub/Sub konusu oluşturmak ve bu konuya abone olmak için:

Google Cloud Console

  1. Google Cloud konsolunda Pub/Sub sayfasına gidin:

    Google Cloud Pub/Sub'a git

    Uygulamanız için Cloud projesinin seçildiğinden emin olun.

  2. Konu oluştur'u tıklayın ve şunları yapın:

    1. Konunuz için workspace-events-topic gibi bir ad girin.
    2. Varsayılan bir abonelik ekle seçeneğini seçili bırakın. Pub/Sub bunu adlandırıyor konunuzun adına benzer varsayılan abonelik (örneğin, workspace-events-topic-sub
    3. İsteğe bağlı: Ek mülkleri güncelleme veya yapılandırma bahsetmek istiyorum.
  3. Oluştur'u tıklayın. Tam konu adınız şu şekilde biçimlendirilir: projects/PROJECT_ID/topics/TOPIC_ID Sonraki adımlarda bu tam adı kullanacaksınız.

  4. Konunuza Pub/Sub mesajları yayınlamak için erişim verin:

    1. Konu sayfanızda, yan panele gidin ve İzinler sekmesini tıklayın.
    2. Ana Hesap Ekle'yi tıklayın.
    3. Ana hesap ekle alanında, etkinlikleri doğrudan müşterilerinize duyuran Google Workspace abonelik:
      1. Chat etkinliklerinde chat-api-push@system.gserviceaccount.com
      2. Meet etkinliklerinde meet-api-event-push@system.gserviceaccount.com
    4. Rol ata menüsünde Pub/Sub Publisher simgesini seçin.
    5. Kaydet'i tıklayın. İzinlerin güncellenmesi birkaç dakika sürebilir bahsetmek istiyorum.

gcloud

  1. Cloud projenizde aşağıdaki komutu çalıştırarak bir konu oluşturun komut:

    gcloud pubsub topics create TOPIC_ID
    

    TOPIC_ID yerine konunuzun benzersiz bir kimliğini girin, örneğin workspace-events-topic olarak.

    Çıkış, konu adının tamamını projects/PROJECT_ID/topics/TOPIC_ID Adı not edin ve girdiğiniz değerin PROJECT_ID, Cloud projesinin kimliğidir en iyi yoludur. Bir sonraki adımda konu adını kullanarak Google Workspace aboneliğinizi iptal edebilirsiniz.

  2. Konunuzla ilgili mesaj yayınlamak için erişim verin:

    gcloud pubsub topics add-iam-policy-binding TOPIC_NAME --member='serviceAccount:GOOGLE_WORKSPACE_APPLICATION' --role='roles/pubsub.publisher'
    

    Aşağıdakini değiştirin:

    • TOPIC_NAME: Konunun tam adı. çıktısını verir. Şu şekilde biçimlendirilmiştir: projects/PROJECT_ID/topics/TOPIC_ID
    • GOOGLE_WORKSPACE_APPLICATION: Şu kullanıcılara etkinlik teslim etmesi gereken Google Workspace uygulaması: aboneliğiniz:

      • Chat'teki etkinlikleri almak için şunu kullanın: chat-api-push@system.gserviceaccount.com
      • Meet'teki etkinlikleri almak için şunu kullanın: meet-api-event-push@system.gserviceaccount.com

    Konunuzun izinlerinin güncellenmesi birkaç dakika sürebilir.

  3. Konu için bir Pub/Sub aboneliği oluşturun:

     gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME
    

    Aşağıdakini değiştirin:

    • SUBSCRIPTION_NAME: Aboneliğiniz için bir ad, (ör. workspace-events-subscription).
    • TOPIC_NAME: Oluşturduğunuz konunuzun adı ele alacağız.

Google Workspace kaynaklarına abone olma

Bu bölümde, şunları sağlayan Google Workspace kaynağına abone olacaksınız: istediğiniz etkinlikleri izleyebilirsiniz.

Hedef kaynağı seçme ve belirleme

Bir Google Workspace aboneliğinde hedef kaynak, Etkinlikler için izlediğiniz Google Workspace kaynağı. Hedef kaynak, aboneliğin targetResource alanında gösterilir ve tam kaynak adını girin. Örneğin, şunları izleyen bir abonelik için: Google Chat alanı (spaces/AAAABBBBBBB), targetResource değeri: //chat.googleapis.com/spaces/AAAABBBBBBB.

Aboneliği oluşturmadan önce aşağıdaki bölümlerden yararlanarak hedef kaynağı belirleyip biçimlendirme.

Chat için hedef kaynak belirleyin

Hedef kaynak Biçim Sınırlamalar
Boşluk

//chat.googleapis.com/spaces/SPACE

burada SPACE, Chat API space kaynağının kaynak adı. Kimliği alanın URL'sinden veya spaces.list() yöntemini çağırın.

Aboneliği yetkilendiren Chat kullanıcısı Google Workspace veya Google üzerinden alana üye olmak Hesap'a dokunun.
Bir kullanıcıya ait tüm alanlar

//chat.googleapis.com/spaces/-

Abonelik yalnızca kullanıcının şuralardaki etkinlikleri alır: Google Workspace veya Google Hesabı üzerinden üyelere.
Kullanıcı

//cloudidentity.googleapis.com/users/USER

burada USER, Chat API user kaynağının kaynak adı. Ayrıntılar için bkz. Tanımlayın ve belirtin Google Chat kullanıcıları.

Abonelik yalnızca kullanıcı hakkında şu etkinlikleri alır: aboneliği yetkilendirdi. Kullanıcı, şurada bir aboneliği yetkilendiremez: diğer kullanıcılar adına da yapabilirsiniz.

Meet için hedef kaynak belirleme

Hedef kaynak Biçim Sınırlamalar (varsa)
Toplantı alanı //meet.googleapis.com/spaces/SPACE

burada SPACE, Meet REST API space kaynağının kaynak adı. Ayrıntılar için bkz. Nasıl? Meet bir toplantı alanı belirler.

Kullanıcı //cloudidentity.googleapis.com/users/USER

burada USER, Meet REST API participant kaynağının signedinUser.user alanı Ayrıntılar için bkz. Katılımcılarla çalışın.

Abonelik, aşağıdaki koşulları karşılayan toplantı alanlarıyla ilgili etkinlikleri alır: şunlardan biridir:

  • Toplantı alanının sahibi.
  • Düzenleyen toplantı alanıyla ilişkili Google Takvim etkinliğinin.

Google Workspace aboneliği oluşturma

Abonelik oluşturmak için Google Workspace Events API'nin Oluşturmak için subscriptions.create() yöntemi Subscription gösterir. Aşağıdaki alanları belirtirsiniz:

  • targetResource: Şurada tanımladığınız bir Google Workspace: önceki bölüm (tam kaynak adı kullanılarak biçimlendirilmiştir).
  • eventTypes: Hakkında bilgi almak istediğiniz bir veya daha fazla etkinlik türü dizisi düşünmesi gerekir. Örneğin, uygulamanızın yalnızca yeni mesajlardan haberdar olması gerekiyorsa bir Chat alanında yayın paylaştığınızda, uygulamanız yalnızca etkinliklere abone olabilir oluşturulan iletiler hakkında.
  • notificationEndpoint: Google Workspace aboneliği etkinlikleri sunar. Önce oluşturduğunuz Pub/Sub konusu.
  • payloadOptions: Dahil edilecek kaynak veri miktarını belirtme seçenekleri gösterir. Bu yapılandırma, abonelik. Daha fazla bilgi için Etkinlik sayfasını inceleyin. verileri ile karşılaştırın.

Google Workspace aboneliği oluşturmak için:

Apps Komut Dosyası

  1. Apps Komut Dosyası projenizde yeni bir komut dosyası oluşturun. createSubscription adlı, aşağıdaki kodu ekleyin:

    function createSubscription() {
      // The Google Workspace resource to monitor for events.
      const targetResource = 'TARGET_RESOURCE';
    
      // The types of events to receive.
      const eventTypes = [EVENT_TYPES];
    
      // The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
      const pubsubTopic = 'TOPIC_NAME';
    
      // Whether to include resource data or not.
      const resourceData = RESOURCE_DATA;
    
      // Call the Workspace Events API using the advanced service.
      const response = WorkspaceEvents.Subscriptions.create({
        targetResource: targetResource,
        eventTypes: eventTypes,
        notificationEndpoint: {
          pubsubTopic: pubsubTopic,
        },
        payloadOptions: {
          includeResource: resourceData
        }
      });
      console.log(response);
    }
    

    Aşağıdakini değiştirin:

    • TARGET_RESOURCE: Google Workspace kaynağı tam kaynak adı şeklinde biçimlendirilmiştir. Örneğin, örneğin, alan kimliğiyle bir Google Chat alanına abone olma AAAABBBB, //chat.googleapis.com/spaces/AAAABBBB hesabını kullanın.
    • EVENT_TYPES: Bir veya daha fazla etkinlik türü bir seçenek belirleyin. Şu şekilde biçimlendir: 'google.workspace.chat.message.v1.created' gibi bir dize dizisidir.
    • TOPIC_NAME: Oluşturulan Pub/Sub konusunun tam adı temel bilgileri ele alacağız. Şu şekilde biçimlendirilmiştir: projects/PROJECT_ID/topics/TOPIC_ID
    • RESOURCE_DATA: abonelik yüke kaynak verilerini dahil ediyor:

      • True: Tüm kaynak verilerini içerir. Hedeflenecek alanları sınırlamak için dahil değilse fieldMask alanına giriş yapın ve değiştirilen kaynak için en az bir alan belirtin. Yalnızca Aşağıdakiler dahil olmak üzere Chat kaynakları desteği abonelikleri: kaynak verileridir.
      • False: Kaynak verileri hariç tutulur.
  2. Google Workspace aboneliğini oluşturmak için işlevi çalıştırın. Apps Komut Dosyası projenizde createSubscription.

Python

  1. Çalışma dizininizde create_subscription.py adlı bir dosya oluşturun. ve aşağıdaki kodu ekleyin:

    """Create subscription."""
    
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = [SCOPES]
    
    # Authenticate with Google Workspace and get user authentication.
    flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
    CREDENTIALS = flow.run_local_server()
    
    # The Google Workspace resource to monitor for events.
    TARGET_RESOURCE = 'TARGET_RESOURCE'
    
    # The types of events to receive.
    EVENT_TYPES = [EVENT_TYPES]
    
    # The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
    TOPIC = 'TOPIC_NAME'
    
    # Call the Workspace Events API using the service endpoint.
    service = build(
        'workspaceevents',
        'v1',
        credentials=CREDENTIALS,
    )
    
    BODY = {
        'target_resource': TARGET_RESOURCE,
        'event_types': EVENT_TYPES,
        'notification_endpoint': {'pubsub_topic': TOPIC},
        'payload_options': {'include_resource': RESOURCE_DATA},
    }
    response = service.subscriptions().create(body=BODY).execute()
    print(response)
    

    Aşağıdakini değiştirin:

    • SCOPES: Her etkinlik türünü destekleyen bir veya daha fazla OAuth kapsamı abonelik için. Dize dizisi olarak biçimlendirilir. Birden fazla kapsamı listelemek için virgülle ayırın. Örneğin, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
    • TARGET_RESOURCE: Google Workspace kaynağı tam kaynak adı şeklinde biçimlendirilmiştir. Örneğin, örneğin, alan kimliğiyle bir Google Chat alanına abone olma AAAABBBB, //chat.googleapis.com/spaces/AAAABBBB hesabını kullanın.
    • EVENT_TYPES: Bir veya daha fazla etkinlik türü bir seçenek belirleyin. Şu şekilde biçimlendir: 'google.workspace.chat.message.v1.created' gibi bir dize dizisidir.
    • TOPIC_NAME: Oluşturulan Pub/Sub konusunun tam adı temel bilgileri ele alacağız. Şu şekilde biçimlendirilmiştir: projects/PROJECT_ID/topics/TOPIC_ID
    • RESOURCE_DATA: abonelik yüke kaynak verilerini dahil ediyor:

      • True: Tüm kaynak verilerini içerir. Hedeflenecek alanları sınırlamak için dahil değilse fieldMask alanına giriş yapın ve değiştirilen kaynak için en az bir alan belirtin. Yalnızca Aşağıdakiler dahil olmak üzere Chat kaynakları desteği abonelikleri: kaynak verileridir.
      • False: Kaynak verileri hariç tutulur.
  2. Google Workspace aboneliğini oluşturmak için aşağıdaki komutu çalıştırın: terminaliniz:

    python3 create_subscription.py
    

Google Workspace Events API, tamamlanan uzun süreli bir etkinlik işlemi Bu, oluşturduğunuz Subscription kaynağının örneğidir.

Google Workspace aboneliğinizi test etme

Google Workspace etkinlikleri alıp almadığınızı test etmek için etkinliği ve pull mesajlarını Pub/Sub aboneliğine taşır.

Google Workspace aboneliğinizi test etmek için:

Google Cloud Console

  1. Sitenizin hedef kaynağında bir veya daha fazla etkinlik türünü tetikleyin Google Workspace aboneliği Örneğin, yeni bir mesaj paylaşmak için alanda mesaj yayınlayın.

  2. Google Cloud konsolunda Pub/Sub sayfasına gidin:

    Pub/Sub'a git

    Uygulamanız için Cloud projesinin seçildiğinden emin olun.

  3. Pub/Sub menüsünde Abonelikler'i tıklayın.

  4. Tabloda konunuzla ilgili Pub/Sub aboneliğini bulun ve abonelik adını da ekleyebilirsiniz.

  5. Mesajlar sekmesini tıklayın.

  6. Çek'i tıklayın. Bir etkinliğin Pub/Sub mesajı.

gcloud

  1. Sitenizin hedef kaynağında bir veya daha fazla etkinlik türünü tetikleyin Google Workspace aboneliği Örneğin, yeni mesajı gönderirken alanda mesaj yayınlayabilirsiniz.

  2. Aşağıdaki komutu çalıştırın:

    gcloud pubsub subscriptions pull PUBSUB_SUBSCRIPTION_NAME --format=json --limit=MESSAGE_COUNT --auto-ack
    

    Aşağıdakini değiştirin:

    • PUBSUB_SUBSCRIPTION_NAME: Adınızın tam adı Şu şekilde biçimlendirilmiş Pub/Sub aboneliği: projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID.
    • MESSAGE_COUNT: Almak istediğiniz maksimum Pub/Sub mesajı sayısı.

    Bir etkinliğin Pub/Sub oluşturması birkaç dakika sürebilir mesajını alırsınız.

Tetiklediğiniz her Google Workspace etkinliği için bir mesaj etkinliği içeren Pub/Sub aboneliğinize iletilir. Ayrıntılar için bkz. Etkinlikleri Google Cloud Pub/Sub mesajları olarak alma.

Uygulamanızın etkinlikleri nasıl alacağını yapılandırın

Oluşturduğunuz Pub/Sub aboneliği pull tabanlıdır. Projenizin, yeni bir erişim noktası kullanıyorsanız dağıtım türünü güncelleyerek Bu da uygulamanızın etkinlik aldığını gösterir. Örneğin, Pub/Sub'ı yapılandırarak Uygulamanızın etkinlikleri alabilmesi için push iletimi türüne abonelik bir uygulama uç noktasına da gönderebilirsiniz.

Pub/Sub aboneliği yapılandırma hakkında bilgi edinmek için Pub/Sub dokümanlarına göz atın.