เอกสาร แหล่งข้อมูล ข่าวสารและอัปเดต ฝ่ายสนับสนุน
ภาษา
เอกสาร Steamworks
GetUserHistory/v0001
เอกสาร Steamworks > คุณสมบัติ > การบริการช่องเก็บของ Steam > ระบบเศรษฐกิจของ Steam > GetUserHistory/v0001
จะคืนค่าระเบียนประวัติการตรวจสอบทางบัญชี (audit record) ทั้งหมดให้แก่ผู้ใช้ตามช่วงเวลาที่ได้กำหนดไว้ โดยช่วงเวลาที่จะส่งคืนนั้นก็คือ อีเวนต์ที่เกิดขึ้นหลังจาก starttime แต่เกิดขึ้นก่อนหรือขณะเดียวกับ endtime

ถูกเรียกโดย: เครื่องมือสนับสนุน

เมธอด HTTP: GET

พารามิเตอร์:

ชื่อประเภทที่ต้องการคำอธิบาย
keystring✔นี่คือ "คีย์เซิร์ฟเวอร์ทรัพยากรy" ที่คุณจัดไว้ให้ในการตั้งค่าระบบเศรษฐกิจของ Steam สำหรับแอปของคุณบนเว็บไซต์พันธมิตร
appiduint32✔ไอดีแอปประเภท 32 บิตของแอปพลิเคชันที่เกี่ยวข้องกับทรัพยากรนั้น
steamiduint64✔ไอดี Steam ประเภท 64 บิตของผู้ใช้ที่จะคืนค่าทรัพยากรไปให้
contextiduint64✔ไอดีประเภท 64 บิตของคอนเทนเนอร์บริบทที่จะใช้รับทรัพยากรให้
starttimeuint32✔เวลาเริ่มของช่วงเวลาที่จะคืนค่าประวัติกลับมาให้ โดยจะต้องระบุเวลาอยู่ในหน่วยของวินาที ที่นับจากวันที่ 1 มกราคม 1970
endtimeuint32✔เวลาสิ้นสุดของช่วงเวลาที่จะคืนค่าประวัติกลับมาให้ โดยจะระบุเวลาดังกล่าวนี้เป็นหน่วยวินาที นับจากวันที่ 1 มกราคม 1970

คืนค่า

เอาต์พุตจากเมธอดนี้ควรถูกเข้ารหัสไว้ในรูปแบบของ JSON

คำตอบ:
  • result
    • success - True หากเมธอดประสบความสำเร็จ หากเซิร์ฟเวอร์ Asset คืนค่า false กลับมา ก็จะตั้งค่า error เป็นสตริงเพื่ออธิบายเหตุผลว่าเกิดอะไรขึ้น
    • error - สตริงอธิบายสาเหตุที่การเรียกนี้ล้มเหลว ข้อความดังกล่าวจะถูกบันทึกไว้ในรายการบันทึกความผิดพลาด ซึ่งจะสามารถใช้งานได้ใน แท็บระบบเศรษฐกิจ ในเว็บไซต์ของ Steamworks
    • transactions - อาร์เรย์ของธุรกรรมที่ปรากฏขึ้นในบัญชีของผู้ใช้ในบริบทนี้ ที่เกิดขึ้นภายในช่วงเวลาที่ได้ระบุไว้
      • timestamp - เวลาที่อีเวนต์นี้ได้เกิดขึ้น โดยจะต้องระบุอยู่ในหน่วยของวินาที ที่นับจากวันที่ 1 มกราคม 1970
      • action - คำอธิบายสั้นๆ สำหรับธุรกรรมนี้
      • actor_steamid (ตัวเลือกเสริม) - Steam ID ประเภท 64 บิตของผู้เริ่มดำเนินการ (initiator) ธุรกรรมดังกล่าวนี้
      • action_steamid (ตัวเลือกเสริม) - Steam ID ประเภท 64 บิตของผู้ใช้ท่านอื่นผู้มีส่วนเกี่ยวข้องในธุรกรรมดังกล่าวนี้
      • records - อาร์เรย์ของรายละเอียดระเบียนประวัติที่อยู่ในธุรกรรม โดยระเบียนประวัติเหล่านี้จะแจ้งให้ทราบถึง Asset หรือหน่วยของการเปลี่ยนแปลงอื่น ๆ ที่เกิดขึ้นกับบริบท
        • action - ชื่อของการดำเนินการที่ได้ดำเนินไปในธุรกรรมดังกล่าวนี้
        • id (ตัวเลือกเสริม) - Asset ID ของ Asset
        • name - ชื่อของ Asset ที่ได้รับผลกระทบจากทะเบียนประวัติ
        • url - URL ที่มีพร้อมด้วยข้อมูลที่เกี่ยวข้องสำหรับระเบียนประวัติดังกล่าวนี้
        • icon_url (ตัวเลือกเสริม) - ไอคอนที่จะใช้สำหรับ Asset นี้ รูปภาพนี้ควรจะอยู่ในรูปแบบของไฟล์ JPEG, GIF หรือ PNG และมีขนาดขั้นต่ำ 96x96 พิกเซล ซึ่งจะนิยมใช้ PNG หรือ GIF มากกว่าเพราะว่าทั้งสองรูปแบบนี้ให้การรองรับความโปร่งแสงของภาพ Steam จะให้บริการการแจกจำหน่ายข้อมูลผ่านทาง CDN ให้แก่รูปภาพทุกรูปในเวลาที่รูปภาพเหล่านั้นได้รับการแสดงผลให้แก่ผู้ใช้ เพราะฉะนั้นจำนวนฮิตที่จะเข้ามายัง URL นี้ก็จะมีค่าที่ค่อนข้างต่ำ
        • context_action (ตัวเลือกเสริม) - อธิบายว่าอะไรได้เกิดขึ้นกับ Asset นี้ที่อยู่ในบริบทนั้นๆ เป็นผลลัพธ์ของการดำเนินการ ค่าที่สามารถรับได้ คือ add remove หรือ modify
        • prefix (ตัวเลือกเสริม) - สตริงนำหน้าที่จะแสดงเอาไว้หน้าชื่อของ Asset ในระเบียนประวัติดังกล่าวนี้
        • color (ตัวเลือกเสริม) - สตริงรหัสสี RGB เป็นเลขฐาน 16 ที่จะใช้กับสตริงนำหน้านี้
        • has_details - ถ้า IGameInventory/SupportGetAssetHistory สามารถส่งข้อมูลที่มีความถูกต้องให้แก่ Asset ดังกล่าวนี้ได้ จะมีค่าเป็น true
        • detail_appid (ตัวเลือกเสริม) - ไอดีแอปสำหรับค้นหารายละเอียด การใช้งานนี้จะมีประโยชน์มาก หากเกม 2 เกมสามารถเล่นร่วมกันแบบข้ามระบบเกมได้ โดยวิธีปฏิบัติตามปกติจะใช้ไอดีแอปเดียวกันกับที่อยู่ในประวัติที่ได้รับมา
        • detail_context (ตัวเลือกเสริม) - ID ประเภท 64 บิตของบริบทที่จะเอาไว้มองหารายละเอียด ซึ่งตามปกตินั้นจะมีค่าเหมือนกับในประวัติบริบทที่ได้รับมา
      • commands - รายการของคำสั่งที่จะแสดงในธุรกรรมดังกล่าวนี้ในเครื่องมือสนับสนุน
        • name - ชื่อของคำสั่ง
        • arguments - อาร์กิวเมนต์ประเภทสตริงที่จะส่งผ่านกลับไปยังเซิร์ฟเวอร์ Asset เวลาที่เรียก GetHistoryCommandDetails เซิร์ฟเวอร์ระบบเศรษฐกิจของ Steam จะไม่ทำความเข้าใจข้อมูลดังกล่าวนี้ไม่ว่าในทางใดก็ตาม เพราะฉะนั้นข้อมูลดังกล่าวสามารถเป็นข้อมูลอะไรก็ได้ที่เกมจำเป็นต้องใช้งาน เพื่อระบุตัวตนของธุรกรรมที่จะต้องใช้งานคำสั่งนี้

ข้อมูลเอาต์พุตตัวอย่าง

{ "result": { "transactions": [ { "records": [ { "action": "Timed Drop", "id": 559964086, "name": "Bushwacka", "icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png", "prefix": "Add", "color": "55FF55" } ] , "commands": [ { "name": "Undo", "arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04AYWN0aW9ucwAAMQACYWN0aW9uAAcAAAAHaWQA\ntl9gIQAAAAAICAgIAA==" }, { "name": "Rollback", "arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04ICAA=" } ] , "timestamp": 1320372088, "action": "Timed Drop: Points: 14114" }, { "records": [ { "action": "Achievement Award", "id": 556669733, "name": "Bombinomicon", "icon_url": "http://media.steampowered.com/apps/440/icons/bombonomicon.6dc3119f20faa08d10161fa876c57265ae46c282.png", "prefix": "Add", "color": "55FF55" } ] , "commands": [ { "name": "Undo", "arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4AYWN0aW9ucwAAMQACYWN0aW9uAAMAAAAHaWQA\nJRsuIQAAAAAICAgIAA==" }, { "name": "Rollback", "arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4ICAA=" } ] , "timestamp": 1320200954, "action": "Achievement Award: TF_HALLOWEEN_LOOT_ISLAND" }, { "records": [ { "action": "Trade", "id": 506851037, "name": "Bushwacka", "icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png", "prefix": "Add", "color": "55FF55" }, { "action": "Trade", "id": 352354754, "name": "Mann Co. Supply Crate", "icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png", "prefix": "Remove", "color": "FF5555" }, { "action": "Trade", "id": 352354753, "name": "Mann Co. Supply Crate", "icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png", "prefix": "Remove", "color": "FF5555" } ] , "commands": [ { "name": "Undo", "arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4AYWN0aW9ucwAAMQACYWN0aW9uABgAAAAHaWQA\n3e41HgAAAAAIADIAAmFjdGlvbgAiAAAAB2lkAMKBABUAAAAACAAzAAJhY3Rpb24AIgAAAAdp\nZADBgQAVAAAAAAgANAACYWN0aW9uACIAAAAHaWQAFwwBHgAAAAAIADUAAmFjdGlvbgAiAAAA\nB2lkALVwYxkAAAAACAA2AAJhY3Rpb24AIgAAAAdpZADd\/5kWAAAAAAgANwACYWN0aW9uACIA\nAAAHaWQAr8WaFgAAAAAIADgAAmFjdGlvbgAiAAAAB2lkAAe9LhcAAAAACAA5AAJhY3Rpb24A\nIgAAAAdpZABcC\/wdAAAAAAgICAgA" }, { "name": "Rollback", "arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4ICAA=" } ] , "timestamp": 1317871321, "action": "Trade", "action_steamid": 76561198007577949 }, ] , "success": true } }
Steamworks คือชุดเครื่องมือและบริการที่สร้างขึ้นโดย Valve ซึ่งจะช่วยคุณกำหนดค่า จัดการ และปฏิบัติการเกี่ยวกับเกมของคุณบน Steam