Bu kılavuzda, bir alanı güncellemek için Google Chat API'nin Space
kaynağındaki patch()
yönteminin nasıl kullanılacağı açıklanmaktadır. Kullanıcılara görünen görünen adı, açıklaması ve yönergeleri gibi alanla ilgili özellikleri değiştirmek için alanı güncelleyin.
Google Workspace yöneticisiyseniz patch()
yöntemini çağırabilirsiniz.
tıklayın.
İlgili içeriği oluşturmak için kullanılan
Space
kaynak
kullanıcıların ve Chat uygulamalarının mesaj gönderebildiği,
dosya paylaşabilir ve ortak çalışabilirsiniz. Birkaç alan türü vardır:
- Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı arasındaki görüşmelerdir. Chat uygulaması
- Grup sohbetleri üç veya daha fazla kullanıcı ile Sohbet uygulamaları.
- Adlandırılmış alanlar kullanıcıların mesaj gönderdiği, dosya paylaştığı, ve ortak çalışma yapabilirsiniz.
Ön koşullar
Node.js
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Bir Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Node.js Cloud İstemci Kitaplığı'nı yükleyin.
-
Bir masaüstü uygulaması için OAuth istemci kimliği kimlik bilgileri oluşturun. Örneği bu
yoksa, kimlik bilgilerini
client_secrets.json
adlı bir JSON dosyası olarak yerel dizini oluşturun.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
- Google Chat alanı. Google Chat API'yi kullanarak alan oluşturmak için Alan oluşturma başlıklı makaleyi inceleyin. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.
Python
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Python Cloud İstemci Kitaplığı'nı yükleyin.
- Masaüstü uygulaması için
OAuth istemci kimliği kimlik bilgileri oluşturun. Örneği bu
yoksa, kimlik bilgilerini
client_secrets.json
adlı bir JSON dosyası olarak yerel dizini oluşturun.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
- Google Chat alanı Google Chat API'yi kullanarak bir tane oluşturmak için Alan oluşturun. Chat'te grup oluşturmak için Yardım Merkezi belgelerini inceleyin.
Java
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Şunu yükleyin: Java Cloud İstemci Kitaplığı.
- Masaüstü uygulaması için
OAuth istemci kimliği kimlik bilgileri oluşturun. Bu kılavuzda yer alan örneği çalıştırmak için kimlik bilgilerini yerel dizininize
client_secrets.json
adlı bir JSON dosyası olarak kaydedin.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
- Google Chat alanı. Google Chat API'yi kullanarak alan oluşturmak için Alan oluşturma başlıklı makaleyi inceleyin. Chat'te grup oluşturmak için Yardım Merkezi belgelerini inceleyin.
Apps Komut Dosyası
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Bağımsız bir Apps Komut Dosyası projesi oluşturun, ve Gelişmiş Sohbet Hizmeti'ni etkinleştirin.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
- Google Chat alanı Google Chat API'yi kullanarak bir tane oluşturmak için Alan oluşturun. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.
Kullanıcı olarak bir alanı güncelleme
Google Chat'teki mevcut bir alanı kullanıcı kimlik doğrulamasıyla güncellemek için isteğinizde aşağıdakileri iletin:
chat.spaces
yetkilendirme kapsamını belirtin.UpdateSpace()
yöntemini çağırın. İsteğinizde alanname
alanını, güncellenecek bir veya daha fazla alanı içerenupdateMask
alanını ve güncellenen alan bilgilerini içeren birbody
alanı belirtirsiniz.
Görünen ad, alan türü, geçmiş durumu gibi bilgileri güncelleyebilirsiniz. Güncelleyebileceğiniz tüm alanları görmek için referans belgelerini inceleyin.
Mevcut bir alanın displayName
alanını güncellemek için:
Node.js
Python
Java
Apps Komut Dosyası
Bu örneği çalıştırmak için SPACE_NAME
alanını alanın name
alanındaki kimlikle değiştirin. Kimliği, ListSpaces()
yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.
Google Chat API, güncellemeleri yansıtan bir Space
örneği döndürür.
Google Workspace yöneticisi olarak bir alanı güncelleme
Google Workspace yöneticisiyseniz
Google Workspace'inizdeki herhangi bir alanı güncellemek için UpdateSpace()
yöntemi
kurum içinde tutmaktır.
Bu yöntemi Google Workspace yöneticisi olarak çağırmak için aşağıdakileri yapın:
- Kullanıcı kimlik doğrulamasını kullanarak yöntemi çağırın ve yöntemin yönetici ayrıcalıkları kullanılarak çağrılmasını destekleyen bir yetkilendirme kapsamı belirtin.
- İsteğinizde
useAdminAccess
sorgu parametresinitrue
olarak belirtin.
Daha fazla bilgi ve örnek için Google Chat alanlarını Google Workspace yöneticisi olarak yönetme
Bir alanı Chat uygulaması olarak güncelleme
Uygulama kimlik doğrulaması bir kerelik gerektirir yönetici onayından yararlanabilir.
Google Chat'te mevcut bir alanı uygulama kimlik doğrulamasıyla güncellemek için isteğinizde aşağıdakileri iletin:
chat.app.spaces
yetkilendirme kapsamını belirtin. Uygulama kimlik doğrulamasıyla yalnızca oluşturulan alanları güncelleyebilirsiniz. .- Şunu çağırın:
patch
yöntemSpace
kaynağında. İçinde isteğiniz için, boşlukname
alanınıupdateMask
Güncellenecek bir veya daha fazla alan ve bir Güncellenen alan bilgileriylebody
.
Görünen ad, alan türü, geçmiş durumu, alan adı ve daha fazlası. Güncelleyebileceğiniz tüm alanları görmek için referans dokümanlarına bakın.
API anahtarı oluşturma
Geliştirici Önizlemesi API yöntemini çağırmak için API keşif belgesinin herkese açık olmayan bir Geliştirici Önizlemesi sürümünü kullanmanız gerekir. İsteğin kimliğini doğrulamak için bir API anahtarı göndermeniz gerekir.
API anahtarı oluşturmak için uygulamanızın Google Cloud projesini açın ve aşağıdakileri yapın:
- Google Cloud Console'da Menü > API'ler ve Hizmetler > Kimlik bilgileri'ne gidin.
- Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
- Yeni API anahtarınız gösterilir.
- API anahtarınızı uygulamanızın kodunda kullanmak için Kopyala'yı seçin. API anahtarı ayrıca "API anahtarları" içinde bulunur kimlik doğrulama bilgileri dahil edilir.
- Gelişmiş ayarları güncellemek ve kullanımı sınırlandırmak için Anahtarı kısıtla'yı tıklayın ekleyin. Daha ayrıntılı bilgi için API anahtarı kısıtlamaları uygulama başlıklı makaleyi inceleyin.
Chat API'yi çağıran bir komut dosyası yazma
Mevcut bir alanın spaceDetails
alanını güncellemek için:
Python
- Çalışma dizininizde
chat_space_update_app.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_space_update_app.py
bölümüne ekleyin:from google.oauth2 import service_account from apiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.app.spaces"] def main(): ''' Authenticates with Chat API using app authentication, then updates the specified space description and guidelines. ''' # Specify service account details. creds = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY') # Use the service endpoint to call Chat API. result = chat.spaces().patch( # The space to update, and the updated space details. # # Replace {space} with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. name='spaces/SPACE', updateMask='spaceDetails', body={ 'spaceDetails': { 'description': 'This description was updated with Chat API!', 'guidelines': 'These guidelines were updated with Chat API!' } } ).execute() # Prints details about the updated space. print(result) if __name__ == '__main__': main()
Kodda aşağıdakileri değiştirin:
API_KEY
: Chat API için hizmet uç noktasını oluşturmak üzere oluşturduğunuz API anahtarı.- Bir alan adıyla
SPACE
şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.
Çalışma dizininizde örneği derleyip çalıştırın:
python3 chat_space_update_app.py
Google Chat API,
Space
kaynak
güncellemelerine göz atın.
İlgili konular
- Bir alanla ilgili ayrıntıları öğrenme.
- Alanları listeleyin.
- Alanı silebilirsiniz.
- Alan oluşturun.
- Doğrudan mesaj alanını bulun.
- Bir alanı belirli kullanıcılar tarafından bulunabilir hale getirin.