新增共用群組成員
Adds users to the set of those able to update both the shared data, as well as the set of users in the group. Only users in the group can add new members. Shared Groups are designed for sharing data between a very small number of players, please see our guide: https://learn.microsoft.com/gaming/playfab/features/social/groups/using-shared-group-data
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| ProductDisabledForTitle | 1609 |
| UserAlreadyAdded | 1235 |
POST
/
Client
/
AddSharedGroupMembers
Add Shared Group Members
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"SharedGroupId": "Clan Data",
"PlayFabIds": [
"D984A64B832",
"F74A523E1562"
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers"
payload = {
"SharedGroupId": "Clan Data",
"PlayFabIds": ["D984A64B832", "F74A523E1562"]
}
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({SharedGroupId: 'Clan Data', PlayFabIds: ['D984A64B832', 'F74A523E1562']})
};
fetch('https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'SharedGroupId' => 'Clan Data',
'PlayFabIds' => [
'D984A64B832',
'F74A523E1562'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers"
payload := strings.NewReader("{\n \"SharedGroupId\": \"Clan Data\",\n \"PlayFabIds\": [\n \"D984A64B832\",\n \"F74A523E1562\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"SharedGroupId\": \"Clan Data\",\n \"PlayFabIds\": [\n \"D984A64B832\",\n \"F74A523E1562\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"SharedGroupId\": \"Clan Data\",\n \"PlayFabIds\": [\n \"D984A64B832\",\n \"F74A523E1562\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}授權
This API requires a client session ticket, available from any Client Login function.
主體
application/json
最後修改於 2026年10月6日
這個頁面有幫助嗎?
⌘I
Add Shared Group Members
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"SharedGroupId": "Clan Data",
"PlayFabIds": [
"D984A64B832",
"F74A523E1562"
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers"
payload = {
"SharedGroupId": "Clan Data",
"PlayFabIds": ["D984A64B832", "F74A523E1562"]
}
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({SharedGroupId: 'Clan Data', PlayFabIds: ['D984A64B832', 'F74A523E1562']})
};
fetch('https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'SharedGroupId' => 'Clan Data',
'PlayFabIds' => [
'D984A64B832',
'F74A523E1562'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers"
payload := strings.NewReader("{\n \"SharedGroupId\": \"Clan Data\",\n \"PlayFabIds\": [\n \"D984A64B832\",\n \"F74A523E1562\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"SharedGroupId\": \"Clan Data\",\n \"PlayFabIds\": [\n \"D984A64B832\",\n \"F74A523E1562\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/AddSharedGroupMembers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"SharedGroupId\": \"Clan Data\",\n \"PlayFabIds\": [\n \"D984A64B832\",\n \"F74A523E1562\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}