গুগল চ্যাট স্পেসে মেসেজ পিন বা আনপিন করুন

চ্যাট এপিআই-এর MessagePin রিসোর্সের মাধ্যমে আপনার অ্যাপ গুগল চ্যাট স্পেসে মেসেজ পিন করতে, আনপিন করতে এবং সমস্ত পিন করা মেসেজের একটি তালিকা পেতে পারে। পিন করা মেসেজগুলো স্পেসের সকল সদস্যের জন্য চ্যাট ইন্টারফেসে দৃশ্যমান থাকে। এই এপিআই আপনার অ্যাপকে একজন ব্যবহারকারীর পক্ষ থেকে পিন করা মেসেজগুলো পরিচালনা করতে সাহায্য করে।

ব্যবহারকারীরা কীভাবে স্পেসে মেসেজ পিন করেন, সে সম্পর্কে জানতে ‘স্পেস ও মেসেজে মেসেজ, ফাইল ও লিঙ্ক পিন করুন’ দেখুন।

পূর্বশর্ত

নোড.জেএস

বিবেচ্য বিষয়সমূহ

  • আপনি শুধুমাত্র সেই মেসেজগুলোই পিন করতে পারবেন যেগুলো একটি স্পেসে আগে থেকেই বিদ্যমান। আপনি একই অনুরোধে একটি নতুন মেসেজ তৈরি করে তা পিন করতে পারবেন না।
  • যে বার্তাগুলো শুধু আপনিই দেখতে পান, সেগুলো আপনি পিন করতে পারবেন না। উদাহরণস্বরূপ, কোনো অ্যাপ থেকে পাওয়া ব্যক্তিগত বার্তা আপনি পিন করতে পারবেন না।
  • প্রতিটি চ্যাট স্পেসে সর্বোচ্চ ১০০টি পিন করা মেসেজ থাকতে পারে। আপনার অ্যাপ যদি ১০১তম মেসেজটি পিন করার চেষ্টা করে, তাহলে এপিআই একটি এরর দেখাবে।

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

ব্যবহারকারী প্রমাণীকরণের মাধ্যমে কোনো বার্তা পিন করতে, আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো দিন:

  • chat.spaces.pins অথবা chat.spaces অনুমোদনের পরিধি নির্দিষ্ট করুন।
  • messagePins.create কল করুন।
  • parent (স্পেসের নাম) নির্দিষ্ট করুন এবং মূল মেসেজের message রিসোর্স নামটি দিয়ে একটি body প্রদান করুন।

নিম্নলিখিত নমুনাটি একটি স্পেসে একটি বার্তা পিন করে:

পাইথন

  1. আপনার ওয়ার্কিং ডিরেক্টরিতে chat_pin_message.py নামে একটি ফাইল তৈরি করুন।

  2. chat_pin_message.py ফাইলে নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
SCOPES = ["https://www.googleapis.com/auth/chat.spaces.pins"]

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

    # Authenticate with Google Workspace and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    service = build('chat', 'v1', credentials=creds)

    # Pin a message.
    result = service.spaces().messagePins().create(
        # The space to pin the message in.
        #
        # Replace SPACE with a space ID or name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',

        # The message to pin.
        body={
            'message': 'spaces/SPACE/messages/MESSAGE'
        }
    ).execute()

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

if __name__ == '__main__':
    main()

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

    • SPACE : স্পেসটির name থেকে প্রাপ্ত আইডি।
    • MESSAGE : বার্তার name থেকে প্রাপ্ত আইডি।

  4. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

    python3 chat_pin_message.py

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

ব্যবহারকারী প্রমাণীকরণের মাধ্যমে কোনো বার্তা আনপিন করতে, আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো দিন:

  • chat.spaces.pins অথবা chat.spaces অনুমোদনের পরিধি নির্দিষ্ট করুন।
  • messagePins.delete কল করুন।
  • যে MessagePin মুছে ফেলতে চান, তার রিসোর্স name সেট করুন।

মেসেজ আনপিন করার পদ্ধতি নিচে দেওয়া হলো:

পাইথন

  1. আপনার ওয়ার্কিং ডিরেক্টরিতে chat_unpin_message.py নামে একটি ফাইল তৈরি করুন।

  2. chat_unpin_message.py ফাইলে নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
SCOPES = ["https://www.googleapis.com/auth/chat.spaces.pins"]

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

    # Authenticate with Google Workspace and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    service = build('chat', 'v1', credentials=creds)

    # Unpin a message.
    result = service.spaces().messagePins().delete(
        # The resource name of the message pin to delete.
        #
        # Replace SPACE with a space ID or name, and MESSAGE with the message ID.
        name='spaces/SPACE/messagePins/MESSAGE'
    ).execute()

    print(result)

if __name__ == '__main__':
    main()

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

    • SPACE : স্পেসটির name থেকে প্রাপ্ত আইডি।
    • MESSAGE : বার্তার name থেকে প্রাপ্ত আইডি।

  4. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

    python3 chat_unpin_message.py

পিন করা বার্তাগুলির একটি তালিকা পান

আপনার অ্যাক্সেস আছে এমন স্পেসগুলিতে পিন করা মেসেজের তালিকা পেতে, ইউজার অথেন্টিকেশন ব্যবহার করুন এবং আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো দিন:

  • নিম্নলিখিত রিডিং স্কোপগুলির মধ্যে একটি নির্দিষ্ট করুন: chat.spaces.pins.readonly , chat.spaces.readonly , chat.spaces.pins , অথবা chat.spaces ।
  • messagePins.list কে কল করুন।
  • পিন করা বার্তাগুলি আনার জন্য স্পেসের নাম হিসেবে parent ' উল্লেখ করুন।

পিন করা মেসেজগুলো তালিকাভুক্ত করার উপায় নিচে দেওয়া হলো:

পাইথন

  1. আপনার ওয়ার্কিং ডিরেক্টরিতে chat_list_pinned_messages.py নামে একটি ফাইল তৈরি করুন।

  2. chat_list_pinned_messages.py ফাইলে নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
SCOPES = ["https://www.googleapis.com/auth/chat.spaces.pins.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then lists pinned messages in a space.
    '''

    # Authenticate with Google Workspace and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    service = build('chat', 'v1', credentials=creds)

    # List pinned messages.
    result = service.spaces().messagePins().list(
        # The space to list pinned messages from.
        #
        # Replace SPACE with a space ID or name.
        parent='spaces/SPACE'
    ).execute()

    print(result)

if __name__ == '__main__':
    main()

  3. কোডে, স্পেসের name থেকে স্পেস আইডি দিয়ে SPACE প্রতিস্থাপন করুন।

  4. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

    python3 chat_list_pinned_messages.py