একটি স্পেসে একজন ব্যবহারকারী, Google গ্রুপ বা Google Chat অ্যাপকে আমন্ত্রণ জানান বা যোগ করুন

এই নির্দেশিকা ব্যাখ্যা করে যে Google Chat API-এর Membership রিসোর্সে create() মেথড ব্যবহার করে ব্যবহারকারী, Google Group, বা Chat অ্যাপকে আমন্ত্রণ জানাতে বা যোগ করতে হয় যেটিকে মেম্বারশিপ তৈরি করা নামেও পরিচিত। একটি সদস্যপদ তৈরি করার সময়, যদি নির্দিষ্ট সদস্যের স্বতঃ-স্বীকার নীতি বন্ধ থাকে, তাহলে তারা আমন্ত্রিত, এবং যোগদানের আগে অবশ্যই স্পেস আমন্ত্রণ গ্রহণ করতে হবে। অন্যথায়, একটি সদস্যপদ তৈরি করা সদস্যকে সরাসরি নির্দিষ্ট স্থানে যোগ করে।

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে পারেন।

Membership রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।

পূর্বশর্ত

Node.js

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

পাইথন

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

জাভা

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

অ্যাপস স্ক্রিপ্ট

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

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

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

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন তার ফিল্ড member সাথে নিম্নলিখিতগুলি সেট করুন:
    • type ফিল্ডটি HUMAN এ সেট করা হয়েছে।
    • name ক্ষেত্রটি users/{user} এ সেট করা হয়েছে যেখানে {user} হল সেই ব্যক্তি যাকে আপনি স্পেসে যোগ করতে চান। চ্যাট ব্যবহারকারীকে নির্দিষ্ট করতে , {user} পরিবর্তে নিচের যেকোনো একটি দিয়ে দিন:
      • পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person resourceName হয় people/123456789 , তাহলে user the value users/123456789 ।
      • ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
      • ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ, users/222larabrown@gmail.com বা users/larabrown@cymbalgroup.com । ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।

নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে ব্যবহারকারীকে যুক্ত করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      member: {
        // Replace USER_NAME here
        name: 'users/USER_NAME',
        // User type for the membership
        type: 'HUMAN'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred.py
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.memberships"]

# This sample shows how to create membership with user credential for a human
# user
def create_membership_with_user_cred():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "member": {
                # Replace USER_NAME here
                "name": "users/USER_NAME",
                # user type for the membership
                "type_": "HUMAN"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCred.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.User;

// This sample shows how to create membership with user credential for a human
// user.
public class CreateMembershipUserCred {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setMember(User.newBuilder()
            // replace USER_NAME here
            .setName("users/USER_NAME")
            // user type for the membership
            .setType(User.Type.HUMAN)));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with user credential for a human user
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCred() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    member: {
      // TODO(developer): Replace USER_NAME here
      name: 'users/USER_NAME',
      // User type for the membership
      type: 'HUMAN'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • USER_NAME : একটি ব্যবহারকারী আইডি।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানান বা যোগ করুন৷

ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যুক্ত করতে ( অ্যাপ প্রমাণীকরণ একটি স্পেসে Google গ্রুপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না), আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন groupMember এর ফিল্ড name সাথে groups/{group} সেট করুন যেখানে {group} হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে।

Google Groups একটি গ্রুপ চ্যাট বা সরাসরি বার্তা যোগ করা যাবে না, কিন্তু শুধুমাত্র একটি নামযুক্ত স্থান যোগ করা যাবে.

নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি নামযুক্ত স্থানে একটি গ্রুপ যুক্ত করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred-for-group.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      groupMember: {
        // Replace GROUP_NAME here
        name: 'groups/GROUP_NAME'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred_for_group.py
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.memberships"]

# This sample shows how to create membership with user credential for a group
def create_membership_with_user_cred_for_group():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "groupMember": {
                # Replace GROUP_NAME here
                "name": "groups/GROUP_NAME"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred_for_group()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCredForGroup.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.Group;

// This sample shows how to create membership with user credential for a group.
public class CreateMembershipUserCredForGroup {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setGroupMember(Group.newBuilder()
            // replace GROUP_NAME here
            .setName("groups/GROUP_NAME")));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with user credential for a group
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCredForGroup() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    groupMember: {
      // TODO(developer): Replace GROUP_NAME here
      name: 'groups/GROUP_NAME'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • GROUP_NAME : একটি গ্রুপ আইডি।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করুন

একটি চ্যাট অ্যাপ একটি স্পেসে সদস্য হিসাবে অন্য অ্যাপ যোগ করতে পারে না। একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করতে বা দুটি মানব ব্যবহারকারীর মধ্যে একটি সরাসরি বার্তা যোগ করতে, ব্যবহারকারীর প্রমাণীকরণের সাথে আপনার অনুরোধে নিম্নলিখিতটি পাস করুন ( অ্যাপ প্রমাণীকরণ একটি স্পেসে চ্যাট অ্যাপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না):

  • chat.memberships.app অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন তার ফিল্ড member সাথে নিম্নলিখিতগুলি সেট করুন:
    • type ফিল্ড BOT এ সেট করা হয়েছে।
    • name ক্ষেত্রটি users/app জন্য সেট করা হয়েছে; একটি উপনাম যা চ্যাট API কলকারী অ্যাপটিকে প্রতিনিধিত্ব করে।

নিম্নলিখিত উদাহরণটি একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred-for-app.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

// This sample shows how to create membership with app credential for an app
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      member: {
        // Member name for app membership, do not change this
        name: 'users/app',
        // User type for the membership
        type: 'BOT'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred_for_app.py
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.memberships.app"]

# This sample shows how to create membership with app credential for an app
def create_membership_with_user_cred_for_app():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "member": {
                # member name for app membership, do not change this.
                "name": "users/app",
                # user type for the membership
                "type_": "BOT"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred_for_app()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCredForApp.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.User;

// This sample shows how to create membership with user credential for the
// calling app.
public class CreateMembershipUserCredForApp {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setMember(User.newBuilder()
            // member name for app membership, do not change this.
            .setName("users/app")
            // user type for the membership
            .setType(User.Type.BOT)));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with app credential for an app
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships.app'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCredForApp() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    member: {
      // Member name for app membership, do not change this
      name: 'users/app',
      // User type for the membership
      type: 'BOT'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, স্পেসের name আইডি দিয়ে SPACE_NAME প্রতিস্থাপন করুন। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

চ্যাট অ্যাপ হিসেবে একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানান বা যোগ করুন

অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।

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

  • chat.app.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • membership রিসোর্সে create পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নামের জন্য parent সেট করুন।
  • member users/{user} এ সেট করুন যেখানে {user} হল সেই ব্যক্তি যার জন্য আপনি সদস্যতা তৈরি করতে চান এবং হয়:
    • পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person resourceName হয় people/123456789 , তাহলে membership.member.name সেট করুন users/123456789 ।
    • ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
    • ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ, users/222larabrown@gmail.com বা users/larabrown@cymbalgroup.com । ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।

একটি API কী তৈরি করুন

একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।

API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
  3. আপনার নতুন API কী প্রদর্শিত হয়৷
    • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
    • উন্নত সেটিংস আপডেট করতে এবং আপনার API কী ব্যবহার সীমিত করতে সীমাবদ্ধ কী ক্লিক করুন। আরও বিশদ বিবরণের জন্য, API কী সীমাবদ্ধতা প্রয়োগ করা দেখুন।

একটি স্ক্রিপ্ট লিখুন যা Chat API কল করে

নিম্নলিখিত উদাহরণটি অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে যুক্ত করে:

পাইথন

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

  2. chat_membership_app_create.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.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then adds a user to a Chat space by creating a membership.
    '''

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

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

    • API_KEY : চ্যাট API-এর জন্য পরিষেবার শেষ পয়েন্ট তৈরি করতে আপনি যে API কী তৈরি করেছেন।

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

    • USER : একটি ব্যবহারকারী আইডি।

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

    python3 chat_membership_app_create.py

Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে একটি স্পেসে ব্যবহারকারী বা Google Groups যোগ করুন

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে create() পদ্ধতিতে কল করতে পারেন।

এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসাবে কল করতে, নিম্নলিখিতগুলি করুন:

  • ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিতে কল করুন এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের বিশেষাধিকার ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে।
  • আপনার অনুরোধে, true ক্যোয়ারী প্যারামিটার useAdminAccess নির্দিষ্ট করুন।

আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।

সীমাবদ্ধতা এবং বিবেচনা

  • অ্যাপ প্রমাণীকরণের মাধ্যমে, একটি চ্যাট অ্যাপ ব্যবহারকারীদের আমন্ত্রণ জানাতে বা যোগ করতে পারে, কিন্তু Google গ্রুপ বা চ্যাট অ্যাপ নয়। নিজেকে যোগ করতে, একটি Chat অ্যাপকে অবশ্যই chat.memberships অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করতে হবে।
,

এই নির্দেশিকা ব্যাখ্যা করে যে Google Chat API-এর Membership রিসোর্সে create() মেথড ব্যবহার করে ব্যবহারকারী, Google Group, বা Chat অ্যাপকে আমন্ত্রণ জানাতে বা যোগ করতে হয় যেটিকে মেম্বারশিপ তৈরি করা নামেও পরিচিত। একটি সদস্যপদ তৈরি করার সময়, যদি নির্দিষ্ট সদস্যের স্বতঃ-স্বীকার নীতি বন্ধ থাকে, তাহলে তারা আমন্ত্রিত, এবং যোগদানের আগে অবশ্যই স্পেস আমন্ত্রণ গ্রহণ করতে হবে। অন্যথায়, একটি সদস্যপদ তৈরি করা সদস্যকে সরাসরি নির্দিষ্ট স্থানে যোগ করে।

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে পারেন।

Membership রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।

পূর্বশর্ত

Node.js

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

পাইথন

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

জাভা

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

অ্যাপস স্ক্রিপ্ট

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

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

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

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন তার ফিল্ড member সাথে নিম্নলিখিতগুলি সেট করুন:
    • type ফিল্ডটি HUMAN এ সেট করা হয়েছে।
    • name ক্ষেত্রটি users/{user} এ সেট করা হয়েছে যেখানে {user} হল সেই ব্যক্তি যাকে আপনি স্পেসে যোগ করতে চান। চ্যাট ব্যবহারকারীকে নির্দিষ্ট করতে , {user} পরিবর্তে নিচের যেকোনো একটি দিয়ে দিন:
      • পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person resourceName হয় people/123456789 , তাহলে user the value users/123456789 ।
      • ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
      • ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ, users/222larabrown@gmail.com বা users/larabrown@cymbalgroup.com । ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।

নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে ব্যবহারকারীকে যুক্ত করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      member: {
        // Replace USER_NAME here
        name: 'users/USER_NAME',
        // User type for the membership
        type: 'HUMAN'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred.py
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.memberships"]

# This sample shows how to create membership with user credential for a human
# user
def create_membership_with_user_cred():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "member": {
                # Replace USER_NAME here
                "name": "users/USER_NAME",
                # user type for the membership
                "type_": "HUMAN"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCred.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.User;

// This sample shows how to create membership with user credential for a human
// user.
public class CreateMembershipUserCred {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setMember(User.newBuilder()
            // replace USER_NAME here
            .setName("users/USER_NAME")
            // user type for the membership
            .setType(User.Type.HUMAN)));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with user credential for a human user
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCred() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    member: {
      // TODO(developer): Replace USER_NAME here
      name: 'users/USER_NAME',
      // User type for the membership
      type: 'HUMAN'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • USER_NAME : একটি ব্যবহারকারী আইডি।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানান বা যোগ করুন৷

ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যুক্ত করতে ( অ্যাপ প্রমাণীকরণ একটি স্পেসে Google গ্রুপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না), আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন groupMember এর ফিল্ড name সাথে groups/{group} সেট করুন যেখানে {group} হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে।

Google Groups একটি গ্রুপ চ্যাট বা সরাসরি বার্তা যোগ করা যাবে না, কিন্তু শুধুমাত্র একটি নামযুক্ত স্থান যোগ করা যাবে.

নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি নামযুক্ত স্থানে একটি গ্রুপ যুক্ত করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred-for-group.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      groupMember: {
        // Replace GROUP_NAME here
        name: 'groups/GROUP_NAME'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred_for_group.py
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.memberships"]

# This sample shows how to create membership with user credential for a group
def create_membership_with_user_cred_for_group():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "groupMember": {
                # Replace GROUP_NAME here
                "name": "groups/GROUP_NAME"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred_for_group()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCredForGroup.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.Group;

// This sample shows how to create membership with user credential for a group.
public class CreateMembershipUserCredForGroup {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setGroupMember(Group.newBuilder()
            // replace GROUP_NAME here
            .setName("groups/GROUP_NAME")));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with user credential for a group
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCredForGroup() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    groupMember: {
      // TODO(developer): Replace GROUP_NAME here
      name: 'groups/GROUP_NAME'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • GROUP_NAME : একটি গ্রুপ আইডি।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করুন

একটি চ্যাট অ্যাপ একটি স্পেসে সদস্য হিসাবে অন্য অ্যাপ যোগ করতে পারে না। একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করতে বা দুটি মানব ব্যবহারকারীর মধ্যে একটি সরাসরি বার্তা যোগ করতে, ব্যবহারকারীর প্রমাণীকরণের সাথে আপনার অনুরোধে নিম্নলিখিতটি পাস করুন ( অ্যাপ প্রমাণীকরণ একটি স্পেসে চ্যাট অ্যাপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না):

  • chat.memberships.app অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন তার ফিল্ড member সাথে নিম্নলিখিতগুলি সেট করুন:
    • type ফিল্ড BOT এ সেট করা হয়েছে।
    • name ক্ষেত্রটি users/app জন্য সেট করা হয়েছে; একটি উপনাম যা চ্যাট API কলকারী অ্যাপটিকে প্রতিনিধিত্ব করে।

নিম্নলিখিত উদাহরণটি একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred-for-app.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

// This sample shows how to create membership with app credential for an app
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      member: {
        // Member name for app membership, do not change this
        name: 'users/app',
        // User type for the membership
        type: 'BOT'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred_for_app.py
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.memberships.app"]

# This sample shows how to create membership with app credential for an app
def create_membership_with_user_cred_for_app():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "member": {
                # member name for app membership, do not change this.
                "name": "users/app",
                # user type for the membership
                "type_": "BOT"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred_for_app()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCredForApp.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.User;

// This sample shows how to create membership with user credential for the
// calling app.
public class CreateMembershipUserCredForApp {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setMember(User.newBuilder()
            // member name for app membership, do not change this.
            .setName("users/app")
            // user type for the membership
            .setType(User.Type.BOT)));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with app credential for an app
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships.app'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCredForApp() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    member: {
      // Member name for app membership, do not change this
      name: 'users/app',
      // User type for the membership
      type: 'BOT'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, স্পেসের name আইডি দিয়ে SPACE_NAME প্রতিস্থাপন করুন। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

চ্যাট অ্যাপ হিসেবে একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানান বা যোগ করুন

অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।

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

  • chat.app.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • membership রিসোর্সে create পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নামের জন্য parent সেট করুন।
  • member users/{user} এ সেট করুন যেখানে {user} হল সেই ব্যক্তি যার জন্য আপনি সদস্যতা তৈরি করতে চান এবং হয়:
    • পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person resourceName হয় people/123456789 , তাহলে membership.member.name সেট করুন users/123456789 ।
    • ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
    • ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ, users/222larabrown@gmail.com বা users/larabrown@cymbalgroup.com । ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।

একটি API কী তৈরি করুন

একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।

API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
  3. আপনার নতুন API কী প্রদর্শিত হয়৷
    • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
    • উন্নত সেটিংস আপডেট করতে এবং আপনার API কী ব্যবহার সীমিত করতে সীমাবদ্ধ কী ক্লিক করুন। আরও বিশদ বিবরণের জন্য, API কী সীমাবদ্ধতা প্রয়োগ করা দেখুন।

একটি স্ক্রিপ্ট লিখুন যা Chat API কল করে

নিম্নলিখিত উদাহরণটি অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে যুক্ত করে:

পাইথন

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

  2. chat_membership_app_create.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.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then adds a user to a Chat space by creating a membership.
    '''

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

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

    • API_KEY : চ্যাট API-এর জন্য পরিষেবার শেষ পয়েন্ট তৈরি করতে আপনি যে API কী তৈরি করেছেন।

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

    • USER : একটি ব্যবহারকারী আইডি।

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

    python3 chat_membership_app_create.py

Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে একটি স্পেসে ব্যবহারকারী বা Google Groups যোগ করুন

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে create() পদ্ধতিতে কল করতে পারেন।

এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসাবে কল করতে, নিম্নলিখিতগুলি করুন:

  • ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিতে কল করুন এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের বিশেষাধিকার ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে।
  • আপনার অনুরোধে, true ক্যোয়ারী প্যারামিটার useAdminAccess নির্দিষ্ট করুন।

আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।

সীমাবদ্ধতা এবং বিবেচনা

  • অ্যাপ প্রমাণীকরণের মাধ্যমে, একটি চ্যাট অ্যাপ ব্যবহারকারীদের আমন্ত্রণ জানাতে বা যোগ করতে পারে, কিন্তু Google গ্রুপ বা চ্যাট অ্যাপ নয়। নিজেকে যোগ করতে, একটি Chat অ্যাপকে অবশ্যই chat.memberships অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করতে হবে।
,

এই নির্দেশিকা ব্যাখ্যা করে যে Google Chat API-এর Membership রিসোর্সে create() মেথড ব্যবহার করে ব্যবহারকারী, Google Group, বা Chat অ্যাপকে আমন্ত্রণ জানাতে বা যোগ করতে হয় যেটিকে মেম্বারশিপ তৈরি করা নামেও পরিচিত। একটি সদস্যপদ তৈরি করার সময়, যদি নির্দিষ্ট সদস্যের স্বতঃ-স্বীকার নীতি বন্ধ থাকে, তাহলে তারা আমন্ত্রিত, এবং যোগদানের আগে অবশ্যই স্পেস আমন্ত্রণ গ্রহণ করতে হবে। অন্যথায়, একটি সদস্যপদ তৈরি করা সদস্যকে সরাসরি নির্দিষ্ট স্থানে যোগ করে।

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে পারেন।

Membership রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।

পূর্বশর্ত

Node.js

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

পাইথন

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

জাভা

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

অ্যাপস স্ক্রিপ্ট

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

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

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

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন তার ফিল্ড member সাথে নিম্নলিখিতগুলি সেট করুন:
    • type ফিল্ডটি HUMAN এ সেট করা হয়েছে।
    • name ক্ষেত্রটি users/{user} এ সেট করা হয়েছে যেখানে {user} হল সেই ব্যক্তি যাকে আপনি স্পেসে যোগ করতে চান। চ্যাট ব্যবহারকারীকে নির্দিষ্ট করতে , {user} পরিবর্তে নিচের যেকোনো একটি দিয়ে দিন:
      • পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person resourceName হয় people/123456789 , তাহলে user the value users/123456789 ।
      • ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
      • ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ, users/222larabrown@gmail.com বা users/larabrown@cymbalgroup.com । ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।

নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে ব্যবহারকারীকে যুক্ত করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      member: {
        // Replace USER_NAME here
        name: 'users/USER_NAME',
        // User type for the membership
        type: 'HUMAN'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred.py
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.memberships"]

# This sample shows how to create membership with user credential for a human
# user
def create_membership_with_user_cred():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "member": {
                # Replace USER_NAME here
                "name": "users/USER_NAME",
                # user type for the membership
                "type_": "HUMAN"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCred.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.User;

// This sample shows how to create membership with user credential for a human
// user.
public class CreateMembershipUserCred {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setMember(User.newBuilder()
            // replace USER_NAME here
            .setName("users/USER_NAME")
            // user type for the membership
            .setType(User.Type.HUMAN)));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with user credential for a human user
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCred() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    member: {
      // TODO(developer): Replace USER_NAME here
      name: 'users/USER_NAME',
      // User type for the membership
      type: 'HUMAN'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • USER_NAME : একটি ব্যবহারকারী আইডি।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানান বা যোগ করুন৷

ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যুক্ত করতে ( অ্যাপ প্রমাণীকরণ একটি স্পেসে Google গ্রুপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না), আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন groupMember এর ফিল্ড name সাথে groups/{group} সেট করুন যেখানে {group} হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে।

Google Groups একটি গ্রুপ চ্যাট বা সরাসরি বার্তা যোগ করা যাবে না, কিন্তু শুধুমাত্র একটি নামযুক্ত স্থান যোগ করা যাবে.

নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি নামযুক্ত স্থানে একটি গ্রুপ যুক্ত করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred-for-group.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      groupMember: {
        // Replace GROUP_NAME here
        name: 'groups/GROUP_NAME'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred_for_group.py
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.memberships"]

# This sample shows how to create membership with user credential for a group
def create_membership_with_user_cred_for_group():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "groupMember": {
                # Replace GROUP_NAME here
                "name": "groups/GROUP_NAME"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred_for_group()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCredForGroup.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.Group;

// This sample shows how to create membership with user credential for a group.
public class CreateMembershipUserCredForGroup {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setGroupMember(Group.newBuilder()
            // replace GROUP_NAME here
            .setName("groups/GROUP_NAME")));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with user credential for a group
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCredForGroup() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    groupMember: {
      // TODO(developer): Replace GROUP_NAME here
      name: 'groups/GROUP_NAME'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • GROUP_NAME : একটি গ্রুপ আইডি।

চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।

একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করুন

একটি চ্যাট অ্যাপ একটি স্পেসে সদস্য হিসাবে অন্য অ্যাপ যোগ করতে পারে না। একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করতে বা দুটি মানব ব্যবহারকারীর মধ্যে একটি সরাসরি বার্তা যোগ করতে, ব্যবহারকারীর প্রমাণীকরণের সাথে আপনার অনুরোধে নিম্নলিখিতটি পাস করুন ( অ্যাপ প্রমাণীকরণ একটি স্পেসে চ্যাট অ্যাপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না):

  • chat.memberships.app অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • CreateMembership() পদ্ধতিতে কল করুন।
  • যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে parent পাস করুন।
  • Membership একটি উদাহরণ হিসাবে membership পাস করুন তার ফিল্ড member সাথে নিম্নলিখিতগুলি সেট করুন:
    • type ফিল্ড BOT এ সেট করা হয়েছে।
    • name ক্ষেত্রটি users/app জন্য সেট করা হয়েছে; একটি উপনাম যা চ্যাট API কলকারী অ্যাপটিকে প্রতিনিধিত্ব করে।

নিম্নলিখিত উদাহরণটি একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করে:

Node.js

chat/client-libraries/cloud/create-membership-user-cred-for-app.js
import {createClientWithUserCredentials} from './authentication-utils.js';

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

// This sample shows how to create membership with app credential for an app
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here.
    parent: 'spaces/SPACE_NAME',
    membership: {
      member: {
        // Member name for app membership, do not change this
        name: 'users/app',
        // User type for the membership
        type: 'BOT'
      }
    }
  };

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

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

main().catch(console.error);

পাইথন

chat/client-libraries/cloud/create_membership_user_cred_for_app.py
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.memberships.app"]

# This sample shows how to create membership with app credential for an app
def create_membership_with_user_cred_for_app():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.CreateMembershipRequest(
        # Replace SPACE_NAME here
        parent = "spaces/SPACE_NAME",
        membership = {
            "member": {
                # member name for app membership, do not change this.
                "name": "users/app",
                # user type for the membership
                "type_": "BOT"
            }
        }
    )

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

    # Handle the response
    print(response)

create_membership_with_user_cred_for_app()

জাভা

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMembershipUserCredForApp.java
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMembershipRequest;
import com.google.chat.v1.Membership;
import com.google.chat.v1.SpaceName;
import com.google.chat.v1.User;

// This sample shows how to create membership with user credential for the
// calling app.
public class CreateMembershipUserCredForApp {

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

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      CreateMembershipRequest.Builder request = CreateMembershipRequest.newBuilder()
        // replace SPACE_NAME here
        .setParent("spaces/SPACE_NAME")
        .setMembership(Membership.newBuilder()
          .setMember(User.newBuilder()
            // member name for app membership, do not change this.
            .setName("users/app")
            // user type for the membership
            .setType(User.Type.BOT)));
      Membership response = chatServiceClient.createMembership(request.build());

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

অ্যাপস স্ক্রিপ্ট

chat/advanced-service/Main.gs
/**
 * This sample shows how to create membership with app credential for an app
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.memberships.app'
 * referenced in the manifest file (appsscript.json).
 */
function createMembershipUserCredForApp() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME here.
  const parent = 'spaces/SPACE_NAME';
  const membership = {
    member: {
      // Member name for app membership, do not change this
      name: 'users/app',
      // User type for the membership
      type: 'BOT'
    }
  };

  // Make the request
  const response = Chat.Spaces.Members.create(membership, parent);

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

নমুনা চালানোর জন্য, SPACE_NAME স্থানটির name থেকে আইডি দিয়ে প্রতিস্থাপন করুন। আপনি ListSpaces() পদ্ধতি বা স্পেসের ইউআরএল থেকে কল করে আইডিটি পেতে পারেন।

চ্যাট এপিআই Membership একটি উদাহরণ দেয় যা তৈরি করা ব্যবহারকারীর সদস্যতার বিবরণ দেয়।

চ্যাট অ্যাপ হিসাবে কোনও স্থানকে আমন্ত্রণ বা যুক্ত করুন

অ্যাপ্লিকেশন প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।

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

  • chat.app.memberships অনুমোদনের সুযোগ উল্লেখ করুন।
  • membership সংস্থানটিতে create পদ্ধতিটি কল করুন।
  • সদস্যপদ তৈরি করার জন্য সেই জায়গার রিসোর্স নামের জন্য parent সেট করুন।
  • users/{user} কাছে member /{ব্যবহারকারী} যেখানে {user} সেই ব্যক্তি যার জন্য আপনি সদস্যতা তৈরি করতে চান এবং তা হয়:
    • পিপল এপিআইয়ের ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি পিপল এপিআই ব্যক্তি resourceName people/123456789 হয়, তবে সদস্যতা সেট করুন membership.member.name users/123456789 ।
    • ডিরেক্টরি এপিআইতে ব্যবহারকারীর জন্য আইডি।
    • ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ, users/222larabrown@gmail.com বা users/larabrown@cymbalgroup.com larabrown@cymbalgroup.com। যদি ব্যবহারকারী কোনও গুগল অ্যাকাউন্ট ব্যবহার করে বা অন্য কোনও গুগল ওয়ার্কস্পেস সংস্থার অন্তর্ভুক্ত থাকে তবে আপনাকে অবশ্যই তাদের ইমেল ঠিকানাটি ব্যবহার করতে হবে।

একটি API কী তৈরি করুন

কোনও বিকাশকারী পূর্বরূপ এপিআই পদ্ধতিতে কল করতে, আপনাকে অবশ্যই এপিআই আবিষ্কারের ডকুমেন্টের একটি অ-পাবলিক বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে। অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি এপিআই কী পাস করতে হবে।

এপিআই কী তৈরি করতে, আপনার অ্যাপ্লিকেশনটির গুগল ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:

  1. গুগল ক্লাউড কনসোলে, মেনু > এপিআইএস এবং পরিষেবাদি > শংসাপত্রগুলিতে যান।

    শংসাপত্রে যান

  2. শংসাপত্র তৈরি করুন > এপিআই কী ক্লিক করুন।
  3. আপনার নতুন এপিআই কী প্রদর্শিত হয়।
    • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার এপিআই কীটি অনুলিপি করতে অনুলিপি করুন ক্লিক করুন। এপিআই কীটি আপনার প্রকল্পের শংসাপত্রগুলির "এপিআই কী" বিভাগেও পাওয়া যাবে।
    • উন্নত সেটিংস আপডেট করতে এবং আপনার এপিআই কীটির সীমাবদ্ধ ব্যবহার সীমাবদ্ধ করতে সীমাবদ্ধ কী ক্লিক করুন। আরও তথ্যের জন্য, এপিআই কী বিধিনিষেধ প্রয়োগ করা দেখুন।

চ্যাট এপিআই কল করে এমন একটি স্ক্রিপ্ট লিখুন

নিম্নলিখিত উদাহরণটি অ্যাপ্লিকেশন প্রমাণীকরণের সাথে কোনও স্থানে ব্যবহারকারীকে যুক্ত করে:

পাইথন

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

  2. chat_membership_app_create.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.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then adds a user to a Chat space by creating a membership.
    '''

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

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

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

    python3 chat_membership_app_create.py

গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হিসাবে ব্যবহারকারী বা গুগল গোষ্ঠীগুলিকে কোনও জায়গাতে যুক্ত করুন

আপনি যদি গুগল ওয়ার্কস্পেস প্রশাসক হন তবে আপনি আপনার গুগল ওয়ার্কস্পেস সংস্থার যে কোনও জায়গাতে ব্যবহারকারী, গুগল গ্রুপ বা চ্যাট অ্যাপ্লিকেশন যুক্ত করতে create() পদ্ধতিটি কল করতে পারেন।

এই পদ্ধতিটিকে গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হিসাবে কল করতে, নিম্নলিখিতগুলি করুন:

  • ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিটি কল করুন এবং প্রশাসকের সুবিধাগুলি ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে এমন একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • আপনার অনুরোধে, ক্যোয়ারী প্যারামিটার useAdminAccess true উল্লেখ করুন।

আরও তথ্য এবং উদাহরণগুলির জন্য, গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হিসাবে গুগল চ্যাট স্পেসগুলি পরিচালনা করুন ।

সীমাবদ্ধতা এবং বিবেচনা

  • অ্যাপ্লিকেশন প্রমাণীকরণের সাথে, একটি চ্যাট অ্যাপ্লিকেশন ব্যবহারকারীদের আমন্ত্রণ জানাতে বা যুক্ত করতে পারে তবে গুগল গ্রুপ বা চ্যাট অ্যাপ্লিকেশনগুলি নয়। নিজেকে যুক্ত করতে, একটি চ্যাট অ্যাপ্লিকেশন অবশ্যই chat.memberships অনুমোদনের সুযোগের সাথে ব্যবহারকারী প্রমাণীকরণ ব্যবহার করতে হবে।