עדכון מרחב משותף

Node.js

• עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.

• מגדירים את הסביבה:
  • יוצרים פרויקט ב-Google Cloud.
  • מגדירים את מסך ההסכמה של OAuth.
  • מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
  • להתקין את Node.js ספריית הלקוח של Cloud.
  • יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה שלנו, שומרים את פרטי הכניסה כקובץ JSON בשם client_secrets.json הספרייה המקומית.
  לקבלת הדרכה, יש לבצע את השלבים להגדרת הסביבה שמפורטים במדריך למתחילים הזה.
• בוחרים את היקף ההרשאה שתומך באימות משתמש.

• מרחב משותף ב-Google Chat. במאמר יצירת מרחב משותף מוסבר איך ליצור מרחב משותף באמצעות Google Chat API. כדי ליצור קבוצה ב-Chat, תוכלו לעיין במסמכי העזרה.

Python

• עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.

• מגדירים את הסביבה:
  • יוצרים פרויקט ב-Google Cloud.
  • מגדירים את מסך ההסכמה של OAuth.
  • מפעילים ומגדירים את Google Chat API עם שם, הסמל והתיאור של אפליקציית Chat.
  • מתקינים את ספריית הלקוח של Cloud ל-Python.
  • יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם client_secrets.json בספרייה המקומית.
  להדרכה, יש לבצע את השלבים להגדרת הסביבה שמפורטים במדריך למתחילים הזה.
• בחירת היקף הרשאה שתומך באימות משתמשים.

• מרחב ב-Google Chat. במאמר יצירת מרחב משותף מוסבר איך ליצור מרחב משותף באמצעות Google Chat API. כדי ליצור הודעה ב-Chat: אפשר להיכנס אל מאמר במרכז העזרה.

Java

• עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.

• מגדירים את הסביבה:
  • יוצרים פרויקט ב-Google Cloud.
  • מגדירים את מסך ההסכמה של OAuth.
  • מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
  • להתקין את Java ספריית הלקוח של Cloud.
  • יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם client_secrets.json בספרייה המקומית.
  לקבלת הדרכה, יש לבצע את השלבים להגדרת הסביבה שמפורטים במדריך למתחילים הזה.
• בוחרים את היקף ההרשאה שתומך באימות משתמש.

• מרחב ב-Google Chat. כדי ליצור חשבון באמצעות Google Chat API: יוצרים מרחב משותף. כדי ליצור הודעה ב-Chat: אפשר להיכנס אל מאמר במרכז העזרה.

Apps Script

• עסק או ארגון חשבון Google Workspace עם גישה אל 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));
    }
  }
}

Apps Script

/**
 * 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: מפתח ה-API שיצרתם כדי ליצור נקודת הקצה של השירות ל-Chat API.
   • SPACE עם שם של מרחב, שאפשר לקבל אמצעי תשלום אחד (spaces.list) מ-Chat API או מכתובת ה-URL של מרחב משותף.

4. בספריית העבודה, יוצרים ומריצים את הדוגמה:

   python3 chat_space_update_app.py