একটি বার্তা আপডেট করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে একটি স্পেসে একটি পাঠ্য বা কার্ড বার্তা আপডেট করতে Google Chat API-এর Message রিসোর্সে patch পদ্ধতি ব্যবহার করতে হয়। বার্তার বৈশিষ্ট্যগুলি পরিবর্তন করতে একটি বার্তা আপডেট করুন, যেমন এটি কী বলে বা একটি কার্ডের বিষয়বস্তু৷ এছাড়াও আপনি একটি কার্ড বার্তার সাথে একটি পাঠ্য বার্তা প্রিপেন্ড করতে পারেন, বা একটি পাঠ্য বার্তায় একটি কার্ড যুক্ত করতে পারেন৷

চ্যাট এপিআইও update পদ্ধতি সমর্থন করে, কিন্তু আমরা দৃঢ়ভাবে patch পদ্ধতিতে কল করার সুপারিশ কারণ এটি একটি PATCH HTTP অনুরোধ ব্যবহার করে যখন update একটি PUT HTTP অনুরোধ ব্যবহার করে। আরও জানতে, AIP-134 এর PATCH এবং PUT বিভাগটি দেখুন।

Message সংস্থান Google চ্যাটে একটি পাঠ্য বা কার্ড বার্তা উপস্থাপন করে। আপনি সংশ্লিষ্ট পদ্ধতিতে কল করে Google Chat API-এ একটি বার্তা create , get , update বা delete পারেন। টেক্সট এবং কার্ড মেসেজ সম্পর্কে আরও জানতে, Google Chat মেসেজ ওভারভিউ দেখুন।

পূর্বশর্ত

পাইথন

  • পাইথন 3.6 বা তার বেশি
  • পাইপ প্যাকেজ ম্যানেজমেন্ট টুল

  • পাইথনের জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib google-auth
  • Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।

  • চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে:

একটি পাঠ্য বার্তা আপডেট করুন, বা ব্যবহারকারীর প্রমাণীকরণ সহ একটি কার্ড বার্তায় একটি পাঠ্য বার্তা প্রিপেন্ড করুন৷

ব্যবহারকারীর প্রমাণীকরণ সহ একটি পাঠ্য বার্তা আপডেট করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.messages অনুমোদনের সুযোগ।
  • আপডেট করার জন্য বার্তার name ।
  • updateMask='text'
  • একটি body যা আপডেট করা বার্তা নির্দিষ্ট করে।

যদি আপডেট করা বার্তাটি একটি কার্ড বার্তা হয়, তাহলে টেক্সট বার্তাটি কার্ড বার্তার সাথে প্রিপেন্ড হয় (যা প্রদর্শিত হতে থাকে)।

এখানে কিভাবে একটি টেক্সট বার্তা আপডেট করতে হয়, বা ব্যবহারকারীর প্রমাণীকরণ সহ একটি কার্ড বার্তায় একটি টেক্সট বার্তা প্রিপেন্ড করতে হয়:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_update_text_message_user.py নামে একটি ফাইল তৈরি করুন।

  2. chat_update_text_message_user.py এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    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.messages"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then updates a message.
    '''

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

    # Update a Chat message.
    result = chat.spaces().messages().patch(

      # The message to update, and the updated message.
      #
      # Replace SPACE with a space name.
      # Obtain the space name from the spaces resource of Chat API,
      # or from a space's URL.
      #
      # Replace MESSAGE with a message name.
      # Obtain the message name from the response body returned
      # after creating a message asynchronously with Chat REST API.
      name='spaces/SPACE/messages/MESSAGE',
      updateMask='text',
      body={'text': 'Updated message!'}

    ).execute()

    # Prints details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।
    • MESSAGE : একটি বার্তার নাম, যা আপনি চ্যাট এপিআই-এর সাথে অসিঙ্ক্রোনাসভাবে একটি বার্তা তৈরি করার পরে বা তৈরির সময় বার্তাটির জন্য নির্ধারিত কাস্টম নামের সাথে ফিরে আসা প্রতিক্রিয়া বডি থেকে পেতে পারেন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    python3 chat_update_text_message_user.py

একটি টেক্সট মেসেজ আপডেট করুন, অথবা অ্যাপ প্রমাণীকরণ সহ একটি কার্ড মেসেজে একটি টেক্সট মেসেজ প্রিপেন্ড করুন

অ্যাপ প্রমাণীকরণ সহ একটি পাঠ্য বার্তা আপডেট করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.bot অনুমোদনের সুযোগ।
  • আপডেট করার জন্য বার্তার name ।
  • updateMask='text'
  • একটি body যা আপডেট করা বার্তা নির্দিষ্ট করে।

যদি আপডেট করা বার্তাটি একটি কার্ড বার্তা হয়, তাহলে টেক্সট বার্তাটি কার্ড বার্তার সাথে প্রিপেন্ড হয় (যা প্রদর্শিত হতে থাকে)।

কিভাবে একটি টেক্সট মেসেজে একটি টেক্সট মেসেজ আপডেট করবেন বা অ্যাপ প্রমাণীকরণের মাধ্যমে একটি কার্ড মেসেজে একটি টেক্সট মেসেজ প্রিপেন্ড করবেন তা এখানে রয়েছে:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_update_text_message_app.py নামে একটি ফাইল তৈরি করুন।

  2. chat_update_text_message_app.py এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Update a Chat message.
result = chat.spaces().messages().patch(

  # The message to update, and the updated message.
  #
  # Replace SPACE with a space name.
  # Obtain the space name from the spaces resource of Chat API,
  # or from a space's URL.
  #
  # Replace MESSAGE with a message name.
  # Obtain the message name from the response body returned
  # after creating a message asynchronously with Chat REST API.
  name='spaces/SPACE/messages/MESSAGE',
  updateMask='text',
  body={'text': 'Updated message!'}

).execute()

# Print Chat API's response in your command line interface.
print(result)

  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।
    • MESSAGE : একটি বার্তার নাম, যা আপনি চ্যাট এপিআই-এর সাথে অসিঙ্ক্রোনাসভাবে একটি বার্তা তৈরি করার পরে বা তৈরির সময় বার্তাটির জন্য নির্ধারিত কাস্টম নামের সাথে ফিরে আসা প্রতিক্রিয়া বডি থেকে পেতে পারেন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    python3 chat_update_text_message_app.py

একটি কার্ড বার্তা আপডেট করুন, বা একটি পাঠ্য বার্তায় একটি কার্ড বার্তা যুক্ত করুন৷

একটি কার্ড বার্তা আপডেট করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.bot অনুমোদনের সুযোগ। একটি কার্ড বার্তা আপডেট করার জন্য অ্যাপ প্রমাণীকরণ প্রয়োজন।
  • আপডেট করার জন্য বার্তার name ।
  • updateMask='cardsV2'
  • একটি body যা আপডেট করা বার্তা নির্দিষ্ট করে।

যদি আপডেট করা বার্তাটি একটি পাঠ্য বার্তা হয়, তাহলে পাঠ্য বার্তার সাথে একটি কার্ড যুক্ত হয় (যা প্রদর্শিত হতে থাকে)। যদি আপডেট করা বার্তাটি নিজেই একটি কার্ড হয়, তাহলে প্রদর্শিত কার্ডটি আপডেট করা হয়।

একটি কার্ড বার্তায় একটি বার্তা কীভাবে আপডেট করবেন তা এখানে:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_update_card_message.py নামে একটি ফাইল তৈরি করুন।

  2. chat_update_card_message.py এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Update a Chat message.
result = chat.spaces().messages().patch(

  # The message to update, and the updated message.
  #
  # Replace SPACE with a space name.
  # Obtain the space name from the spaces resource of Chat API,
  # or from a space's URL.
  #
  # Replace MESSAGE with a message name.
  # Obtain the message name from the response body returned
  # after creating a message asynchronously with Chat REST API.
  name='spaces/SPACE/messages/MESSAGE',
  updateMask='cardsV2',
  body=
  {
    'cardsV2': [{
      'cardId': 'updateCardMessage',
      'card': {
        'header': {
          'title': 'An Updated Card Message!',
          'subtitle': 'Updated with Chat REST API',
          'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
          'imageType': 'CIRCLE'
        },
        'sections': [
          {
            'widgets': [
              {
                'buttonList': {
                  'buttons': [
                    {
                      'text': 'Read the docs!',
                      'onClick': {
                        'openLink': {
                          'url': 'https://developers.google.com/chat'
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }]
  }

).execute()

# Print Chat API's response in your command line interface.
print(result)

  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।

    • MESSAGE : একটি বার্তার নাম, যা আপনি চ্যাট এপিআই-এর সাথে অসিঙ্ক্রোনাসভাবে একটি বার্তা তৈরি করার পরে বা তৈরির সময় বার্তাটির জন্য নির্ধারিত কাস্টম নামের সাথে ফিরে আসা প্রতিক্রিয়া বডি থেকে পেতে পারেন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    python3 chat_update_card_message.py

চ্যাট এপিআই Message একটি উদাহরণ প্রদান করে যা আপডেট করা বার্তাটির বিবরণ দেয়।

একই সাথে একাধিক ফিল্ড পাথ সহ একটি বার্তা আপডেট করুন

যখন একটি বার্তা আপডেট করা হয়, তখন আপনি একাধিক বার্তা ক্ষেত্রের পথ আপডেট করতে পারেন৷ উদাহরণস্বরূপ, একটি আপডেট বার্তা অনুরোধে, আপনি একই সময়ে text এবং cardsv2 ক্ষেত্রের পাথগুলিতে একটি পরিবর্তন নির্দিষ্ট করতে পারেন, যা বার্তার পাঠ্য এবং কার্ড উভয়ই আপডেট করে। যদি বার্তাটিতে কেবল পাঠ্য থাকে এবং কোনও কার্ড না থাকে তবে বার্তাটিতে একটি কার্ড যুক্ত করা হয়। সমর্থিত ক্ষেত্র পাথ সম্পর্কে আরও তথ্যের জন্য, updateMask পরামিতি দেখুন।

ব্যবহারকারীর প্রমাণীকরণ সহ একটি বার্তার text এবং card উভয়ই আপডেট করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.messages অনুমোদনের সুযোগ।
  • আপডেট করার জন্য বার্তার name ।

  • একটি updateMask যা আপডেট করার জন্য বার্তা ক্ষেত্রের পথগুলি নির্দিষ্ট করে, কমা দ্বারা পৃথক করা হয়: updateMask='text', 'cardsV2' ।

  • একটি body যা আপডেট করা বার্তা নির্দিষ্ট করে, সমস্ত আপডেট করা ফিল্ড পাথ সহ।

ব্যবহারকারীর প্রমাণীকরণ সহ একটি বার্তায় text এবং cardsV2 ফিল্ড পাথগুলি কীভাবে আপডেট করবেন তা এখানে রয়েছে:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_update_text_message_user.py নামে একটি ফাইল তৈরি করুন।

  2. chat_update_text_message_user.py এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    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.messages"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then updates a message.
    '''

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

    # Update a Chat message.
    result = chat.spaces().messages().patch(

      # The message to update, and the updated message.
      #
      # Replace SPACE with a space name.
      # Obtain the space name from the spaces resource of Chat API,
      # or from a space's URL.
      #
      # Replace MESSAGE with a message name.
      # Obtain the message name from the response body returned
      # after creating a message asynchronously with Chat REST API.
      name='spaces/SPACE/messages/MESSAGE',
      updateMask='text,cardsV2',
      body=
      {'text': 'Updated message!',
            'cardsV2': [{
              'cardId': 'updateCardMessage',
              'card': {
                'header': {
                  'title': 'An Updated Card Message!',
                  'subtitle': 'Updated with Chat REST API',
                  'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
                  'imageType': 'CIRCLE'
                },
                'sections': [
                  {
                    'widgets': [
                      {
                        'buttonList': {
                          'buttons': [
                            {
                              'text': 'Read the docs!',
                              'onClick': {
                                'openLink': {
                                  'url': 'https://developers.google.com/chat'
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }]
      }

    ).execute()

    # Prints details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।
    • MESSAGE : একটি বার্তার নাম, যা আপনি চ্যাট এপিআই-এর সাথে অসিঙ্ক্রোনাসভাবে একটি বার্তা তৈরি করার পরে বা তৈরির সময় বার্তাটির জন্য নির্ধারিত কাস্টম নামের সাথে ফিরে আসা প্রতিক্রিয়া বডি থেকে পেতে পারেন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    python3 chat_update_text_message_user.py