User Profile

Obtaining your personal profile

This API is used to obtain your personal profile. For more information on the properties, see Profile.

Custom profile fields are supported since SDK v2.3.2. Before using this API, upgrade your SDK to v2.3.2 or later.

API name

tim.getMyProfile()

Returned values

This API returns a Promise object. The callback functions are as follows:

• The callback function parameter for then is IMResponse. You can obtain your personal profile from IMResponse.data.
• The callback function parameter for catch is IMError.

Sample

let promise = tim.getMyProfile();
promise.then(function(imResponse) {
  console.log(imResponse.data); // Personal profile from the profile instance
}).catch(function(imError) {
  console.warn('getMyProfile error:', imError); // Information on the failure in obtaining the personal profile.
});

Obtaining other users’ profiles

This API is used to obtain standard profile fields and Custom Profile Fields.

Custom profile fields are supported since SDK v2.3.2. Before using this API, upgrade your SDK to v2.3.2 or later.
If you have not configured any custom profile fields or you have configured custom profile fields but have not set the values, this API will not return custom profile information.

API name

tim.getUserProfile(options)

Request Parameters

The options parameter is of the Object type. It contains the following property values:

Returned values

This API returns a Promise object. The callback functions are as follows:

• The callback function parameter for then is IMResponse. You can obtain other users’ profiles from IMResponse.data.
• The callback function parameter for catch is IMError.

Sample

let promise = tim.getUserProfile({
  userIDList: ['user1', 'user2'] // Note: even if you retrieve only one user’s profile, the value must be of the array type, for example, userIDList: ['user1'].
});
promise.then(function(imResponse) {
  console.log(imResponse.data); // The array that stores other users’ profiles - [Profile]
}).catch(function(imError) {
  console.warn('getUserProfile error:', imError); // Information on the failure in obtaining other users’ profiles.
});

Updating your personal profile

Custom profile fields are supported since SDK v2.3.2. Before using this API, upgrade your SDK to v2.3.2 or later.

API name

tim.updateMyProfile(options)

Request Parameters

The options parameter is of the Object type. It contains the following property values:

Returned values

This API returns a Promise object. The callback functions are as follows:

• The callback function parameter for then is IMResponse. You can obtain other users’ new profiles from IMResponse.data.
• The callback function parameter for catch is IMError.

Sample

// Modify your personal standard profile.
let promise = tim.updateMyProfile({
  nick: 'My profile',
  avatar: 'http(s)://url/to/image.jpg',
  gender: TIM.TYPES.GENDER_MALE,
  selfSignature: 'My personal signature',
  allowType: TIM.TYPES.ALLOW_TYPE_ALLOW_ANY
});
promise.then(function(imResponse) {
  console.log(imResponse.data); // The profile is updated.
}).catch(function(imError) {
  console.warn('updateMyProfile error:', imError); // Information on the failure in updating the personal profile.
});

// Modify my personal custom profile.
// Custom profile fields must be configured on the IM console in advance. For more information, see https://intl.cloud.tencent.com/document/product/1047/33520.
let promise = tim.updateMyProfile({
  // Ensure that you have applied for the custom profile field Tag_Profile_Custom_Test1 in the IM console by clicking the desired app card and choosing **Feature Configuration** > **User Custom Field**.
  // Note: even if only this one custom data field exists, the format of profileCustomField must be of array type.
  profileCustomField: [
    {
      key: 'Tag_Profile_Custom_Test1',
      value: 'My custom profile 1'
    }
  ]
});
promise.then(function(imResponse) {
  console.log(imResponse.data); // The profile is updated.
}).catch(function(imError) {
  console.warn('updateMyProfile error:', imError); // Information on the failure in updating the personal profile.
});

// Modify my personal standard profile and custom profile.
let promise = tim.updateMyProfile({
  nick: 'My profile',
  // Ensure that you have applied for the custom profile fields Tag_Profile_Custom_Test1 and Tag_Profile_Custom_Test2 in the IM console by clicking the desired app card and choosing **Feature Configuration** > **User Custom Field**.
  profileCustomField: [
    {
      key: 'Tag_Profile_Custom_Test1',
      value: 'My custom profile 1'
    },
    {
      key: 'Tag_Profile_Custom_Test2',
      value: 'My custom profile 2'
    },
  ]
});
promise.then(function(imResponse) {
  console.log(imResponse.data); // The profile is updated.
}).catch(function(imError) {
  console.warn('updateMyProfile error:', imError); // Information on the failure in updating the personal profile.
});

Blocklists

Obtaining my blocklist

API name

tim.getBlacklist()

Request Parameters

The options parameter is of the Object type. It contains the following property values:

Returned values

This API returns a Promise object. The callback functions are as follows:

• The callback function parameter for then is IMResponse. You can obtain the blocklist from IMResponse.data.
• The callback function parameter for catch is IMError.

Sample

let promise = tim.getBlacklist();
promise.then(function(imResponse) {
  console.log(imResponse.data); // My blocklist. The value is an array that contains userIDs - [userID].
}).catch(function(imError) {
  console.warn('getBlacklist error:', imError); // Information on the failure in obtaining the blocklist.
});

Adding a user to the blocklist

This API is used to add a user to the blocklist. By adding a user to the blocklist, you can block all the messages sent by the user. Therefore, this API can be used to block the messages of a specified user.

• If user A and user B are friends, the two-way friend relationship is terminated when either A or B is blocked by the other user.
• If user A and user B are in a blocklist relationship, neither user A nor user B can send a friend request to the other user.
• If both user A and user B have blocked each other, user A and user B cannot set up a chat session.
• If user A has blocked user A but user B has not blocked user A, user A can send a message to user B, but user B cannot send a message to user A.

API name

tim.addToBlacklist(options)

Request Parameters

The options parameter is of the Object type. It contains the following property values:

Returned values

This API returns a Promise object. The callback functions are as follows:

• The callback function parameter for then is IMResponse. You can obtain the blocklist from IMResponse.data.
• The callback function parameter for catch is IMError.

Sample

let promise = tim.addToBlacklist({userIDList: ['user1', 'user2']}); // Note: even if you add only one userID to the blocklist, the value must be of array type, for example, userIDList: ['user1'].
promise.then(function(imResponse) {
  console.log(imResponse.data); // Information on the userIDs that are added to the blocklist. The value must be an array that contains userIDs - [userID].
}).catch(function(imError) {
  console.warn('addToBlacklist error:', imError); // Information on the failure in adding userIDs to the blocklist.
});

Removing a user from the blocklist

This API is used to delete a user from the blocklist. After deleting the user from the blocklist, you can receive all the messages sent by the user.

API name

tim.removeFromBlacklist(options)

Request Parameters

The options parameter is of the Object type. It contains the following property values:

Returned values

This API returns a Promise object. The callback functions are as follows:

• The callback function parameter for then is IMResponse. You can obtain the userIDs that are deleted from the blocklist from IMResponse.data.
• The callback function parameter for catch is IMError.

Sample

let promise = tim.removeFromBlacklist({userIDList: ['user1', 'user2']}); // Note: even if you delete only one userID from the blocklist, the value must be of array type, for example, userIDList: ['user1'].
result.then(function(imResponse) {
  console.log(imResponse.data); // All userIDs that are deleted from the blocklist. The value is an array that contains the userIDs - [userID].
}).catch(function(imError) {
  console.warn('removeFromBlacklist error:', imError); // Information on the failure in deleting users from the blocklist.
});