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:
- Ortamınızı ayarlayın.
- 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.
- Google Workspace Events API'yi
create()
çağırın yönteminiSubscription
gösterir. - Pub/Sub'ın eksiksiz olduğundan emin olmak için Google Workspace aboneliğinizi test edin konu, abone olduğunuz etkinlikleri alır.
- 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ı
- Bu kılavuzdaki Google Cloud CLI komutlarını kullanmak için:
- Google Cloud KSA'yı yükleyin.
- Alıcı:
gcloud
CLI'yı başlatın, aşağıdaki kodu çalıştırın:
gcloud init
- 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: - Etkinleştir
Google Workspace Events
gelişmiş hizmetini kullanabilirsiniz.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
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
- Bu kılavuzdaki Google Cloud CLI komutlarını kullanmak için:
- Google Cloud KSA'yı yükleyin.
- Alıcı:
gcloud
CLI'yı başlatın, aşağıdaki kodu çalıştırın:
gcloud init
- 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:
gcloud
Çalışma dizininizde Google Hesabınızda oturum açın:
gcloud auth login
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.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ı
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > Web uygulaması'nı tıklayın.
- Ad alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- 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.
- 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.
- Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi OAuth 2.0 İstemci Kimlikleri altında görünür.
Android
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > Android'i tıklayın.
- "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- "Paket adı" bölümünde alanına,
AndroidManifest.xml
dosyanızdaki paket adını girin. - "SHA-1 sertifikası dijital parmak izi"nde alanına, oluşturulan SHA-1 sertifika parmak izinizi girin.
- Oluştur'u tıklayın. Yeni İstemci Kimliğinizin gösterildiği OAuth istemcisi oluşturuldu ekranı görünür.
- Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.
iOS
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > iOS'u tıklayın.
- "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- "Paket kimliği"nde alanına, uygulamanın
Info.plist
dosyasında listelendiği şekilde paket tanımlayıcısını girin. - İsteğe bağlı: Uygulamanız Apple App Store'da görünüyorsa App Store kimliğini girin.
- İsteğe bağlı: "Ekip Kimliği"nde alanına, Apple tarafından oluşturulan ve ekibinize atanan 10 karakterlik benzersiz dizeyi girin.
- 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.
- Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.
Chrome uygulaması
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > Chrome uygulaması'nı tıklayın.
- "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- "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.
- 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.
- Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.
Masaüstü uygulaması
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > Masaüstü uygulaması'nı tıklayın.
- Ad alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- 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.
- 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ı
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > TV'ler ve Sınırlı Giriş cihazları.
- "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- 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.
- Tamam'ı tıklayın. Yeni oluşturulan kimlik bilgisi "OAuth 2.0 İstemci Kimlikleri" altında görünür.
Evrensel Windows Platformu (UWP)
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri.
- Kimlik Bilgisi Oluştur > OAuth istemci kimliği'ni tıklayın.
- Uygulama türü > Evrensel Windows Platformu (UWP) seçeneğini tıklayın.
- "Ad" bölümünde alanına kimlik bilgisi için bir ad yazın. Bu ad yalnızca Google Cloud konsolunda gösterilir.
- "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.
- 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.
- 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.
Google Cloud konsolunda Menü'ye gidin > API'lar ve Hizmetler > Kimlik bilgileri.
OAuth 2.0 Client IDs (OAuth 2.0 İstemci Kimlikleri) bölümünde, oluşturduğunuz istemci kimliğini tıklayın.
JSON'u indir'i tıklayın.
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
Google Cloud konsolunda Pub/Sub sayfasına gidin:
Uygulamanız için Cloud projesinin seçildiğinden emin olun.
Konu oluştur'u tıklayın ve şunları yapın:
- Konunuz için
workspace-events-topic
gibi bir ad girin. - 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
- İsteğe bağlı: Ek mülkleri güncelleme veya yapılandırma bahsetmek istiyorum.
- Konunuz için
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.Konunuza Pub/Sub mesajları yayınlamak için erişim verin:
- Konu sayfanızda, yan panele gidin ve İzinler sekmesini tıklayın.
- Ana Hesap Ekle'yi tıklayın.
- Ana hesap ekle alanında,
etkinlikleri doğrudan müşterilerinize duyuran Google Workspace
abonelik:
- Chat etkinliklerinde
chat-api-push@system.gserviceaccount.com
- Meet etkinliklerinde
meet-api-event-push@system.gserviceaccount.com
- Chat etkinliklerinde
- Rol ata menüsünde
Pub/Sub Publisher
simgesini seçin. - Kaydet'i tıklayın. İzinlerin güncellenmesi birkaç dakika sürebilir bahsetmek istiyorum.
gcloud
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ğinworkspace-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.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
- Chat'teki etkinlikleri almak için şunu kullanın:
Konunuzun izinlerinin güncellenmesi birkaç dakika sürebilir.
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 |
burada SPACE,
Chat API |
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 |
|
Abonelik yalnızca kullanıcının şuralardaki etkinlikleri alır: Google Workspace veya Google Hesabı üzerinden üyelere. |
Kullanıcı |
burada USER,
Chat API |
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 |
|
Kullanıcı | //cloudidentity.googleapis.com/users/USER
burada USER,
Meet REST API |
Abonelik, aşağıdaki koşulları karşılayan toplantı alanlarıyla ilgili etkinlikleri alır: şunlardan biridir:
|
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 konusudur.payloadOptions
: Dahil edilecek kaynak veri miktarını belirtme seçenekleri yardımcı olur. 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ı
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 olmaAAAABBBB
,//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ğilsefieldMask
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.
Google Workspace aboneliğini oluşturmak için işlevi çalıştırın. Apps Komut Dosyası projenizde
createSubscription
.
Python
Ç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 olmaAAAABBBB
,//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ğilsefieldMask
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.
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 ve pull mesajlarını Pub/Sub aboneliğine taşır.
Google Workspace aboneliğinizi test etmek için:
Google Cloud Console
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.
Google Cloud konsolunda Pub/Sub sayfasına gidin:
Uygulamanız için Cloud projesinin seçildiğinden emin olun.
Pub/Sub menüsünde Abonelikler'i tıklayın.
Tabloda konunuzla ilgili Pub/Sub aboneliğini bulun ve abonelik adını da ekleyebilirsiniz.
Mesajlar sekmesini tıklayın.
Çek'i tıklayın. Bir etkinliğin Pub/Sub mesajı.
gcloud
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.
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.