تعديل مساحة

Node.js

• نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat

• إعداد بيئتك:
  • أنشِئ مشروعًا على Google Cloud.
  • إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
  • فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
  • تثبيت Node.js Cloud Client Library.
  • أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ العيّنة الواردة في هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم client_secrets.json في الدليل المحلي.
  للحصول على إرشادات، أكمِل خطوات إعداد بيئتك في الدليل المفصّل للبدء السريع.
• اختَر نطاق تفويض يتيح مصادقة المستخدمين.

• مساحة في Google Chat لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة

Python

• نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat

• إعداد بيئتك:
  • أنشئ مشروعًا على Google Cloud.
  • ضبط شاشة موافقة OAuth
  • تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
  • تثبيت بايثون Cloud Client Library.
  • أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ العيّنة الواردة في هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم client_secrets.json في الدليل المحلي.
  للحصول على إرشادات، أكمِل خطوات إعداد بيئتك في الدليل المفصّل للبدء السريع.
• اختر نطاق تفويض يتيح مصادقة المستخدم.

• مساحة Google Chat لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء حساب في Chat، انتقِل إلى مستندات مركز المساعدة.

Java

• حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat

• إعداد البيئة:
  • أنشِئ مشروعًا على Google Cloud.
  • ضبط شاشة موافقة OAuth
  • تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
  • ثبِّت مكتبة Cloud Client Library لـ Java.
  • أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ العيّنة الواردة في هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم client_secrets.json في الدليل المحلي.
  للحصول على إرشادات، أكمِل خطوات إعداد بيئتك في الدليل المفصّل للبدء السريع.
• اختَر نطاق تفويض يتيح مصادقة المستخدمين.

• مساحة في Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء حساب في Chat، انتقِل إلى مستندات مركز المساعدة.

برمجة تطبيقات

• حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat

• إعداد بيئتك:
  • أنشِئ مشروعًا على Google Cloud.
  • ضبط شاشة موافقة OAuth
  • فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
  • أنشئ مشروعًا مستقلاً في Apps Script، وفعِّل خدمة Chat المتقدّمة.
  للاطّلاع على الخطوات اللازمة لإعداد البيئة، يُرجى إكمال هذا التشغيل السريع.
• اختر نطاق تفويض يتيح مصادقة المستخدم.

• مساحة Google Chat لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء حساب في Chat، انتقِل إلى مستندات مركز المساعدة.

Node.js

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.spaces'];

// This sample shows how to update a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    space: {
      // Replace SPACE_NAME here
      name: 'spaces/SPACE_NAME',
      displayName: 'New space display name'
    },
    // The field paths to update. Separate multiple values with commas or use
    // `*` to update all field paths.
    updateMask: {
      // The field paths to update.
      paths: ['display_name']
    }
  };

  // Make the request
  const response = await chatClient.updateSpace(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Python

from authentication_utils import create_client_with_user_credentials
from google.apps import chat_v1 as google_chat

SCOPES = ["https://www.googleapis.com/auth/chat.spaces"]

# This sample shows how to update a space with user credential
def update_space_with_user_cred():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.UpdateSpaceRequest(
        space = {
            # Replace SPACE_NAME here
            'name': 'spaces/SPACE_NAME',
            'display_name': 'New space display name'
        },
        # The field paths to update. Separate multiple values with commas.
        update_mask = 'displayName'
    )

    # Make the request
    response = client.update_space(request)

    # Handle the response
    print(response)

update_space_with_user_cred()

Java

import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.UpdateSpaceRequest;
import com.google.chat.v1.Space;
import com.google.protobuf.FieldMask;

// This sample shows how to update space with user credential.
public class UpdateSpaceUserCred {

  private static final String SCOPE =
    "https://www.googleapis.com/auth/chat.spaces";

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      UpdateSpaceRequest.Builder request = UpdateSpaceRequest.newBuilder()
        .setSpace(Space.newBuilder()
          // Replace SPACE_NAME here.
          .setName("spaces/SPACE_NAME")
          .setDisplayName("New space display name"))
        .setUpdateMask(FieldMask.newBuilder()
          // The field paths to update.
          .addPaths("display_name"));
      Space response = chatServiceClient.updateSpace(request.build());

      System.out.println(JsonFormat.printer().print(response));
    }
  }
}

برمجة تطبيقات

/**
 * This sample shows how to update a space with user credential
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces'
 * referenced in the manifest file (appsscript.json).
 */
function updateSpaceUserCred() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here
  const name = 'spaces/SPACE_NAME';
  const space = {
    displayName: 'New space display name'
  };
  // The field paths to update. Separate multiple values with commas or use
  // `*` to update all field paths.
  const updateMask = 'displayName';

  // Make the request
  const response = Chat.Spaces.patch(space, name, {
    updateMask: updateMask
  });

  // Handle the response
  console.log(response);
}

Python

1. في دليل العمل، أنشِئ ملفًا باسم "chat_space_update_app.py".

2. أدرِج الرمز التالي في chat_space_update_app.py:

   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()
   

3. في الرمز، استبدِل ما يلي:

   • API_KEY: مفتاح واجهة برمجة التطبيقات الذي أنشأته لإنشاء نقطة نهاية الخدمة لواجهة برمجة تطبيقات Chat.
   • "SPACE" باسم مساحة التي يمكنك الحصول عليها من طريقة واحدة (spaces.list) في Chat API أو من عنوان URL للمساحة.

4. في دليل العمل، أنشئ النموذج وشغِّله:

   python3 chat_space_update_app.py