设置游戏数据和覆盖
Set and delete key-value pairs in a title data override instance.
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| DataLengthExceeded | 1146 |
| DuplicateKeys | 1509 |
| InvalidParams | 1000 |
| TooManyKeys | 1147 |
POST
/
Admin
/
SetTitleDataAndOverrides
Set Title Data And Overrides
curl --request POST \
--url https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"OverrideLabel": "Holiday title data",
"TitleId": "8FF3A797",
"KeyValues": [
{
"Key": "Running Speed",
"Value": "1.03"
},
{
"Key": "Walking Speed",
"Value": "0.05"
}
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides"
payload = {
"OverrideLabel": "Holiday title data",
"TitleId": "8FF3A797",
"KeyValues": [
{
"Key": "Running Speed",
"Value": "1.03"
},
{
"Key": "Walking Speed",
"Value": "0.05"
}
]
}
headers = {
"X-SecretKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
OverrideLabel: 'Holiday title data',
TitleId: '8FF3A797',
KeyValues: [{Key: 'Running Speed', Value: '1.03'}, {Key: 'Walking Speed', Value: '0.05'}]
})
};
fetch('https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides', 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/Admin/SetTitleDataAndOverrides",
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([
'OverrideLabel' => 'Holiday title data',
'TitleId' => '8FF3A797',
'KeyValues' => [
[
'Key' => 'Running Speed',
'Value' => '1.03'
],
[
'Key' => 'Walking Speed',
'Value' => '0.05'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SecretKey: <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/Admin/SetTitleDataAndOverrides"
payload := strings.NewReader("{\n \"OverrideLabel\": \"Holiday title data\",\n \"TitleId\": \"8FF3A797\",\n \"KeyValues\": [\n {\n \"Key\": \"Running Speed\",\n \"Value\": \"1.03\"\n },\n {\n \"Key\": \"Walking Speed\",\n \"Value\": \"0.05\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-SecretKey", "<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/Admin/SetTitleDataAndOverrides")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"OverrideLabel\": \"Holiday title data\",\n \"TitleId\": \"8FF3A797\",\n \"KeyValues\": [\n {\n \"Key\": \"Running Speed\",\n \"Value\": \"1.03\"\n },\n {\n \"Key\": \"Walking Speed\",\n \"Value\": \"0.05\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"OverrideLabel\": \"Holiday title data\",\n \"TitleId\": \"8FF3A797\",\n \"KeyValues\": [\n {\n \"Key\": \"Running Speed\",\n \"Value\": \"1.03\"\n },\n {\n \"Key\": \"Walking Speed\",\n \"Value\": \"0.05\"\n }\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 title secret key, available to title admins, from PlayFab Game Manager.
请求体
application/json
Will set the given key values in the specified override or the primary title data based on whether the label is provided or not.
Will set the given key values in the specified override or the primary title data based on whether the label is provided or not.
最后修改于 2026年10月6日
此页面对您有帮助吗?
⌘I
Set Title Data And Overrides
curl --request POST \
--url https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"OverrideLabel": "Holiday title data",
"TitleId": "8FF3A797",
"KeyValues": [
{
"Key": "Running Speed",
"Value": "1.03"
},
{
"Key": "Walking Speed",
"Value": "0.05"
}
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides"
payload = {
"OverrideLabel": "Holiday title data",
"TitleId": "8FF3A797",
"KeyValues": [
{
"Key": "Running Speed",
"Value": "1.03"
},
{
"Key": "Walking Speed",
"Value": "0.05"
}
]
}
headers = {
"X-SecretKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
OverrideLabel: 'Holiday title data',
TitleId: '8FF3A797',
KeyValues: [{Key: 'Running Speed', Value: '1.03'}, {Key: 'Walking Speed', Value: '0.05'}]
})
};
fetch('https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides', 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/Admin/SetTitleDataAndOverrides",
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([
'OverrideLabel' => 'Holiday title data',
'TitleId' => '8FF3A797',
'KeyValues' => [
[
'Key' => 'Running Speed',
'Value' => '1.03'
],
[
'Key' => 'Walking Speed',
'Value' => '0.05'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SecretKey: <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/Admin/SetTitleDataAndOverrides"
payload := strings.NewReader("{\n \"OverrideLabel\": \"Holiday title data\",\n \"TitleId\": \"8FF3A797\",\n \"KeyValues\": [\n {\n \"Key\": \"Running Speed\",\n \"Value\": \"1.03\"\n },\n {\n \"Key\": \"Walking Speed\",\n \"Value\": \"0.05\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-SecretKey", "<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/Admin/SetTitleDataAndOverrides")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"OverrideLabel\": \"Holiday title data\",\n \"TitleId\": \"8FF3A797\",\n \"KeyValues\": [\n {\n \"Key\": \"Running Speed\",\n \"Value\": \"1.03\"\n },\n {\n \"Key\": \"Walking Speed\",\n \"Value\": \"0.05\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Admin/SetTitleDataAndOverrides")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"OverrideLabel\": \"Holiday title data\",\n \"TitleId\": \"8FF3A797\",\n \"KeyValues\": [\n {\n \"Key\": \"Running Speed\",\n \"Value\": \"1.03\"\n },\n {\n \"Key\": \"Walking Speed\",\n \"Value\": \"0.05\"\n }\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": {}
}