Obtener usuarios del grupo

Documentos de API

Obtener usuarios del grupo

Obtiene información de los usuarios que pertenecen a un grupo.

Método	GET
URL	https://{subdomain}.kintone.com/v1/group/users.json
Autenticación	Autenticación mediante token API , Autenticación mediante contraseña , Autenticación mediante sesión
Content-Type	application/json (no es necesario si se especifica la consulta con una cadena de consulta)

Permisos

Todos los usuarios que no sean usuarios invitados pueden usar esta API.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
code	Cuerda	Sí	El código de grupo.
offset	Integer	Opcional	La compensación. Si se omite, este valor es 0.
size	Integer	Opcional	El número máximo de usuarios que se pueden obtener del grupo. Si se omite, este valor es 100.

Solicitud de muestra

JavaScript using kintone.api()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


var body = {
  'code': 'sample_group_code',
  'offset': 0,
  'size': 100
};
kintone.api(kintone.api.url('/v1/group/users.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


var params = '?code=sample_group_code&offset=0&size=50';
var url = 'https://{subdomain}.kintone.com/v1/group/users.json' + params;
console.log(url);
var xhr = new XMLHttpRequest();
xhr.open('GET', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send();

Parámetros de respuesta

Parámetro	Tipo	Descripción
users	Arreglo	Una lista de usuarios y sus puestos de trabajo que pertenecen al grupo, como tipos de usuario. Para obtener más información sobre los tipos de usuarios, consulte el siguiente enlace: Tipo de usuario

Ejemplo de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80


{
  "users": [
    {
      "birthDate": "2011-05-01",
      "callto": "",
      "code": "a",
      "ctime": "2013-07-22T08:12:18Z",
      "customItemValues": [
        {
          "code": "item1",
          "value": "aitem1"
        },
        {
          "code": "secret",
          "value": "aitem2"
        }
      ],
      "description": "",
      "email": "",
      "employeeNumber": "",
      "extensionNumber": "",
      "givenName": "",
      "givenNameReading": "",
      "id": "1",
      "joinDate": "2013-01-01",
      "localName": "",
      "localNameLocale": "en",
      "locale": "",
      "mobilePhone": "",
      "mtime": "2013-07-22T09:00:45Z",
      "name": "a",
      "phone": "",
      "primaryOrganization": null,
      "sortOrder": 2147483647,
      "surName": "a",
      "surNameReading": "",
      "timezone": "America/Los_Angeles",
      "url": "",
      "valid": true
    },
    {
      "birthDate": "2011-05-01",
      "callto": "",
      "code": "b",
      "ctime": "2013-07-22T08:12:18Z",
      "customItemValues": [
        {
          "code": "item1",
          "value": "bitem1"
        },
        {
          "code": "secret",
          "value": "bitem2"
        }
      ],
      "description": "",
      "email": "",
      "employeeNumber": "",
      "extensionNumber": "",
      "givenName": "",
      "givenNameReading": "",
      "id": "1",
      "joinDate": "2013-01-01",
      "localName": "",
      "localNameLocale": "en",
      "locale": "",
      "mobilePhone": "",
      "mtime": "2013-07-22T09:00:45Z",
      "name": "a",
      "phone": "",
      "primaryOrganization": null,
      "sortOrder": 2147483647,
      "surName": "a",
      "surNameReading": "",
      "timezone": "America/Los_Angeles",
      "url": "",
      "valid": true
    }
  ]
}