Bu kılavuzda,
create()
yöntemini kullanın.Space
İ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ı ile Chat uygulaması arasındaki görüşmelerdir.
- Grup sohbetleri, üç veya daha fazla kullanıcı ile Chat uygulamaları arasındaki görüşmelerdir.
- Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.
Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı yerlerdir. Adlandırılmış alanlar Chat uygulamalarını içerebilir. Adlandırılmış alanlar Adsız grup görüşmeleri ve doğrudan mesajlar içeren ek özellikler içerir bunlara sahip değildir (ör. yönetim ayarlarını uygulayabilen alan yöneticileri, açıklamaları, kişi ve uygulamaları ekleyip kaldırabilirsiniz. Adlandırılmış alan oluşturduktan sonra alanın tek üyesi, kimliği doğrulanmış kullanıcıdır. Alana, alanı oluşturan Chat uygulaması dahil olmak üzere başka kullanıcı veya uygulama eklenemez. Bir alana üye eklemek için şuraya bakın: Üyelik oluşturun.
Birden fazla üyenin yer aldığı bir alan (üç veya daha fazla kullanıcının yer aldığı adsız bir grup sohbeti ya da iki kullanıcı veya bir kullanıcı ile Chat API'yi çağıran Chat uygulaması arasındaki doğrudan mesaj görüşmesi) oluşturmak için alan oluşturun.
Ön koşullar
Node.js
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
- Ortamınızı ayarlayın:
- Bir Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Google Chat API'yi etkinleştirin ve yapılandırın. Bunun için bir ad girin, Chat uygulamanızın simgesi ve açıklaması.
- Node.js Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimliğinizi doğrulama yönteminize göre erişim kimlik bilgileri oluşturun:
- Chat kullanıcısı olarak kimliğinizi doğrulamak için:
OAuth istemci kimliği oluştur
kimlik bilgilerini iki kez tıklayın ve kimlik bilgilerini
client_secrets.json
dosyasını yerel dizininize ekleyin. - Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini
credentials.json
adlı bir JSON dosyası olarak kaydedin.
- Chat kullanıcısı olarak kimliğinizi doğrulamak için:
OAuth istemci kimliği oluştur
kimlik bilgilerini iki kez tıklayın ve kimlik bilgilerini
- Kimlik doğrulamasını kullanıcı olarak mı yoksa Chat uygulaması.
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.
- Google Chat API'yi etkinleştirin ve yapılandırın. Bunun için bir ad girin, Chat uygulamanızın simgesi ve açıklaması.
- Şunu yükleyin: Python Cloud İstemci Kitaplığı.
- Google Chat API'nizde nasıl kimlik doğrulama yapmak istediğinize bağlı olarak erişim kimlik bilgilerini oluşturun
istek:
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
client_secrets.json
adlı bir JSON dosyası olarak kaydedin. - Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini
credentials.json
adlı bir JSON dosyası olarak kaydedin.
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
- Kimlik doğrulamasını kullanıcı olarak mı yoksa Chat uygulaması.
Java
- 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.
- Google Chat API'yi etkinleştirin ve yapılandırın. Bunun için bir ad girin, Chat uygulamanızın simgesi ve açıklaması.
- Şunu yükleyin: Java Cloud İstemci Kitaplığı.
- Google Chat API isteğinizde kimliğinizi doğrulama yönteminize göre erişim kimlik bilgileri oluşturun:
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
client_secrets.json
adlı bir JSON dosyası olarak kaydedin. - Chat uygulaması olarak kimliğinizi doğrulamak için:
hizmet hesabı oluştur
kimlik bilgilerini iki kez tıklayın ve kimlik bilgilerini
credentials.json
.
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
- Kullanıcı olarak mı yoksa Chat uygulaması olarak mı kimlik doğrulama yapmak istediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
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ş Chat Hizmeti'ni etkinleştirin.
- Bu kılavuzda kullanıcı veya uygulama kimlik doğrulamasını kullanmanız gerekir. Sohbet uygulaması olarak kimlik doğrulama yapmak için hizmet hesabı kimlik bilgileri oluşturun. Adımlar için Google Chat uygulaması olarak kimlik doğrulama ve yetkilendirme başlıklı makaleyi inceleyin.
- Kimlik doğrulamasını kullanıcı olarak mı yoksa Chat uygulaması.
Kullanıcı olarak adlandırılmış alan oluşturma
Kullanıcı kimlik doğrulaması içeren bir adlandırılmış alan oluşturmak için isteğinizde aşağıdakileri iletin:
chat.spaces.create
veyachat.spaces
yetkilendirme kapsamını belirtin.space
öğesini aşağıdaki alanlarla birlikteSpace
örneği olarak göndererekCreateSpace()
yöntemini çağırın:spaceType
şu değere ayarlandı:SPACE
.displayName
, alanın kullanıcılar tarafından görülebilen adına ayarlandı.- İsteğe bağlı olarak, aşağıdakiler gibi diğer özellikleri ayarlayın:
spaceDetails
- kullanıcıların görebildiği bir açıklama ve ortaya çıkar.predefinedPermissionSettings
: Alan için önceden tanımlanmış izinler. Örneğin, alan adını tüm üyelerin veya yalnızca alanın dahil olacağı şekilde yapılandırabilirsiniz. yöneticilere ileti gönderebilir.
Adlandırılmış alan oluşturmak için:
Node.js
Python
Java
Apps Komut Dosyası
Chat uygulaması olarak adlandırılmış alan oluşturma
Uygulama kimlik doğrulaması bir kerelik gerektirir yönetici onayından yararlanabilir.
Şununla bir alana kullanıcı davet etmek veya kullanıcı eklemek için: uygulama kimlik doğrulaması, kart şunları belirtin:
chat.app.spaces.create
veyachat.app.spaces
yetkilendirme kapsamını belirtin.- Şunu çağırın:
create
yöntem uygulamasındaSpace
kaynak. - Ayarla
spaceType
Hedef:SPACE
. displayName
alanın kullanıcı tarafından görülebilen adına ayarlayın. Aşağıdaki örnektedisplayName
,API-made
olarak ayarlanmıştır.customer
alanını kullanarak Google Workspace alanının müşteri kimliğini belirtin.- İsteğe bağlı olarak,
spaceDetails
(alan için kullanıcıların görebileceği bir açıklama ve bir dizi yönerge).
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ı iletmeniz gerekir.
API anahtarını oluşturmak için uygulamanızın Google Cloud projesini açıp aşağıdakileri yapın:
- Google Cloud konsolunda Menü'ye gidin > API'lar ve Hizmetler > Kimlik bilgileri.
- Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
- Yeni API anahtarınız gösterilir.
- Kopyala'yı tıklayın. özelliğini kullanabilirsiniz. API anahtarı ayrıca "API anahtarları" içinde bulunur kimlik doğrulama bilgileri dahil edilir.
- Gelişmiş ayarları güncellemek ve API anahtarınızın kullanımını sınırlamak için Anahtarı kısıtla'yı tıklayın. 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
Adlandırılmış alan oluşturmak için:
Python
- Çalışma dizininizde
chat_space_create_named_app.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_space_create_named_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.create"] def main(): ''' Authenticates with Chat API using app authentication, then creates a Chat space. ''' # 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().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made', # The customer ID of the Workspace domain. 'customer': 'CUSTOMER' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
Bu kodda, aşağıdakini değiştirin:
API_KEY
: derlemek için oluşturduğunuz API anahtarı Chat API için hizmet uç noktası.CUSTOMER
: alanına ait müşteri kimliği{customer}
değeriID
olmak üzerecustomer/{customer}
biçiminde boşluk şuradan Yönetici SDK'sı müşteri kaynağı. Şununla aynı Google Workspace kuruluşunda alan oluşturmak için: Chat uygulaması içincustomers/my_customer
kullanın.
Çalışma dizininizde örneği derleyip çalıştırın:
python3 chat_space_create_named_app.py
Alanı Google Chat'te açma
Alana gitmek için alanın URL'sini oluşturmak üzere alanın kaynak kimliğini kullanın. Kaynak kimliğini alanda bulabilirsiniz
Google Chat yanıt gövdesinde name
. Örneğin, alanınızın name
değeri spaces/1234567
ise şu URL'yi kullanarak alana gidebilirsiniz: https://mail.google.com/chat/u/0/#chat/space/1234567
.
İlgili konular
- Üye oluşturarak alana kullanıcı ve uygulama ekleyin.
- Alanda mesaj yayınlamak için: bir mesaj oluşturarak.
- Bir alanla ilgili ayrıntıları öğrenme.
- Alanları listeleyin.
- Alanları güncelleme
- Alanı silebilirsiniz.
- Alan oluşturun.
- Doğrudan mesaj alanı bulun.
- Alanları belirli kullanıcılar tarafından bulunabilir hale getirme