Bu kılavuzda, membership
kaynağında create
yönteminin nasıl kullanılacağı açıklanmaktadır.
Google Chat API'nin kullanıcıları, Google Grupları veya
Chat uygulamasını kullanarak bir alana,
üyeliği. Üyelik oluştururken, belirtilen üyenin
otomatik kabul politikası devre dışı bırakıldı, ardından davet edilirler ve alanı kabul etmeleri gerekir
davet edin. Aksi takdirde, üyelik oluşturulduğunda üye eklenir.
doğrudan belirtilen alana ekleyebilirsiniz.
İlgili içeriği oluşturmak için kullanılan
Membership
kaynak
bir gerçek kullanıcının veya Google Chat uygulamasının davet edilip edilmediğini
bir alanın parçası olan ya da olmayan
Ön koşullar
Python
- İş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ı.
- Şunu yükleyin: Python Google API İstemci Kitaplığı.
-
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.
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ı.
- Şunu yükleyin: Node.js Google API İstemci Kitaplığı.
-
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.
Alanlara kullanıcı davet etme veya kullanıcı ekleme
Bir alana kullanıcı davet etmek veya bir alana kullanıcı eklemek için istek:
chat.memberships
yetkilendirme kapsamını belirtin.- Şunu çağırın:
create
yöntem uygulamasındamembership
kaynak. parent
değerini, üyelik oluşturulacak alanın kaynak adı olarak belirleyin.member
değeriniusers/{user}
olarak ayarlayın. Burada{user}
, istediğiniz kişidir ve şunlardan birini yapar:- için kimliği
kişi
ile iletişime geçin. Örneğin, People API
kişi
resourceName
değeripeople/123456789
, ardındanmembership.member.name
olarak ayarlandıusers/123456789
adlı konuma. - için kimliği kullanıcı bulun.
- Kullanıcının e-posta adresi. Örneğin,
users/222larabrown@gmail.com
veyausers/larabrown@cymbalgroup.com
. Kullanıcı bir Google Hesabı kullanıyorsa veya Google Workspace kuruluşuna aitse e-posta adresi.
- için kimliği
kişi
ile iletişime geçin. Örneğin, People API
kişi
Aşağıdaki örnekte bir alana kullanıcı eklenir:
Python
- Çalışma dizininizde şu ada sahip bir dosya oluşturun:
chat_membership_user_create.py
Aşağıdaki kodu
chat_membership_user_create.py
bölümüne ekleyin:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then adds a user to a Chat space by creating a membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Specify which user the membership is for. body = { 'member': { 'name':'users/USER', 'type': 'HUMAN' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
Bu kodda, aşağıdakini değiştirin:
SPACE
: bir alan adı; şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.USER
: bir kullanıcı kimliği.
Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_membership_user_create.py
Node.js
- Çalışma dizininizde
add-user-to-space.js
adlı bir dosya oluşturun. Aşağıdaki kodu
add-user-to-space.js
bölümüne ekleyin:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the user to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/USER', type: 'HUMAN'}} }); } addUserToSpace().then(console.log);
Bu kodda, aşağıdakini değiştirin:
SPACE
: şuradan edinebileceğiniz bir alan adı:spaces.list
yöntem API'den veya bir alanın URL'sinden.USER
: bir kullanıcı kimliği.
Çalışma dizininizde örneği çalıştırın:
node add-user-to-space.js
Chat API,
membership
kullanıcı üyeliğinin ayrıntılarını içerir.
Alanlara Google Grubu davet etme veya ekleme
Bir alana Google Grubu eklemek veya bir Google Grubunu davet etmek için istek:
chat.memberships
yetkilendirme kapsamını belirtin.- Şunu çağırın:
create
yöntem uygulamasındamembership
kaynak. parent
değerini, üyelik oluşturulacak alanın kaynak adı olarak belirleyin.groupMember
değerinigroups/{group}
olarak ayarlayın. Burada{group}
, istediğiniz grup kimliğidir tercih edebilirsiniz. Grubun kimliği, Cloud Identity API. Örneğin, Cloud Identity APIgroups/123456789
adlı bir grup döndürür, ardındanmembership.groupMember.name
-groups/123456789
.
Google Grupları, grup sohbetine veya doğrudan mesaja eklenmez. Yalnızca belirli bir gruba eklenebilir. adlandırılmış alan. Aşağıdaki örnekte, adlandırılmış bir alana bir grup eklenir:
Python
- Çalışma dizininizde şu ada sahip bir dosya oluşturun:
chat_membership_group_create.py
Aşağıdaki kodu
chat_membership_group_create.py
bölümüne ekleyin:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then adds a group to a Chat space by creating a membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().create( # The named space in which to create a membership. parent = 'spaces/SPACE', # Specify which group the membership is for. body = { 'groupMember': { 'name':'groups/GROUP', } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
Bu kodda, aşağıdakini değiştirin:
SPACE
: bir alan adı; şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.GROUP
: Grup kimliği.
Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_membership_group_create.py
Node.js
- Çalışma dizininizde
add-group-to-space.js
adlı bir dosya oluşturun. Aşağıdaki kodu
add-group-to-space.js
bölümüne ekleyin:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the group to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {groupMember: {name: 'groups/GROUP'}} }); } addUserToSpace().then(console.log);
Bu kodda, aşağıdakini değiştirin:
SPACE
: şuradan edinebileceğiniz bir alan adı:spaces.list
yöntem API'den veya bir alanın URL'sinden.GROUP
: Grup kimliği.
Çalışma dizininizde örneği çalıştırın:
node add-group-to-space.js
Chat API,
membership
oluşturulan grup üyeliğinin ayrıntılarını içerir.
Alanlara Chat uygulaması ekleme
Bir Chat uygulaması, başka bir uygulamayı boşluk oluşturur. Bir alana Chat uygulaması eklemek için: veya iki gerçek kullanıcı arasındaki doğrudan mesajları iletmeniz halinde isteğinizde aşağıdakileri de iletin:
chat.memberships.app
yetkilendirme kapsamını belirtin.- Şunu çağırın:
create
yöntemmembership
kaynağında. parent
değerini, üyelik oluşturulacak alanın kaynak adı olarak belirleyin.member
değeriniusers/app
olarak ayarlayın; çağrıyı yapan uygulamayı temsil eden Chat API'ye gidin.
Aşağıdaki örnek, bir alana Chat uygulaması ekler:
Python
- Çalışma dizininizde şu ada sahip bir dosya oluşturun:
chat_membership_app_create.py
Aşağıdaki kodu
chat_membership_app_create.py
bölümüne ekleyin:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.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.memberships.app"] def main(): ''' Authenticates with Chat API via user credentials, then adds the Chat app to a Chat space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Set the Chat app as the entity that gets added to the space. # 'app' is an alias for the Chat app calling the API. body = { 'member': { 'name':'users/app', 'type': 'BOT' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
Kodda,
SPACE
öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_membership_app_create.py
Node.js
- Çalışma dizininizde
add-app-to-space.js
adlı bir dosya oluşturun. Aşağıdaki kodu
add-app-to-space.js
bölümüne ekleyin:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the app to the Chat space. * @return {!Promise<!Object>} */ async function addAppToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships.app', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/app', type: 'BOT'}} }); } addAppToSpace().then(console.log);
Kodda,
SPACE
öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.Çalışma dizininizde örneği çalıştırın:
node add-app-to-space.js
Chat API,
membership
ayrıntılı bir şekilde inceleyebilirsiniz.
İlgili konular
- Bir kullanıcının veya Chat uygulamasının üyeliğiyle ilgili ayrıntıları öğrenin.
- Bir alandaki üyeleri listeleyin.
- Google Chat alanındaki kullanıcıların üyeliğini güncelleyin.
- Bir kullanıcıyı veya Chat uygulamasını alandan kaldırın.