Steamworks-dokumentasjon
Grensesnitt – IPublishedFileService
Inneholder ytterligere metoder for samhandling med gjenstander i Steam Workshop.

Se ISteamRemoteStorage for hovedgrensesnittet, og ICloudService.

MERK: Dette er et tjenestegrensesnitt. Metoder i dette grensesnittet bør kalles med parameteren input_json.

Gå til Oversikt over nett-API for mer informasjon om nett-API-et til Steamworks.

Delete

GET https://api.steampowered.com/IPublishedFileService/Delete/v1/
NavnTypePåkrevdBeskrivelse
keystringBrukernøkkel for nett-API-et til Steamworks.
publishedfileiduint64Gjenstand som skal slettes.
appiduint32Applikasjonen som gjenstanden hører til.

Sletter en gjenstand.

MERK: Dette kallet krever en API-utgivernøkkel for å bruke denne metoden. Derfor dette API-et kalles fra en sikker tjener og kan aldri brukes direkte av klienter!

QueryFiles

GET https://api.steampowered.com/IPublishedFileService/QueryFiles/v1/
NavnTypePåkrevdBeskrivelse
keystringBrukernøkkel for nett-API-et til Steamworks.
query_typeuint32IPublishedFileService#EPublishedFileQueryType
pageuint32Gjeldende side. For øyeblikket er det en maksgrense på 1000.
cursorstringMarkør for å dele resultatene i sider (angi som * i den første forespørselen). Bør brukes fremfor å bruke sideparameteren, da det lar deg få tilgang til flere sider. Hvis dette brukes, ignoreres sideparameteren. Bruk verdien «next_cursor», som returneres i svaret, til å sette opp den neste spørringen for å få det neste resultatsettet.
numperpageuint32(Valgfritt) Antall resultater per side som skal returneres.
creator_appiduint32Applikasjonen som opprettet filene.
appiduint32Applikasjonen som bruker filene.
requiredtagsstringMerkelapper som skal samsvares med. Se parameteren match_all_tags nedenfor.
excludedtagsstring(Valgfritt) Merkelapper som IKKE kan være til stede på en publisert fil for å samsvare med spørringen.
match_all_tagsboolHvis sann må gjenstander ha alle angitte merkelapper – ellers må de ha minst én merkelapp.
required_flagsstringNødvendige flagg som må være angitt på returnerte gjenstander.
omitted_flagsstringFlagg som ikke kan være angitt på returnerte gjenstander.
search_textstringTekst som skal samsvare med gjenstandens navn eller beskrivelse.
filetypeuint32IPublishedFileService#EPublishedFileInfoMatchingFileType
child_publishedfileiduint64Finn alle gjenstander med referanse til den angitte gjenstanden.
daysuint32Hvis query_type er k_PublishedFileQueryType_RankedByTrend, er dette antall dager å hente stemmer for [1,7].
include_recent_votes_onlyboolHvis query_type er k_PublishedFileQueryType_RankedByTrend, begrenses resultatsettet til gjenstander som har stemmer innenfor angitt tidsramme.
cache_max_age_secondsuint32La foreldet data returneres i angitt antall sekunder.
languageint32Språk å søke på, og også det som returneres. Engelsk er standard.
required_kv_tags{message}Nødvendige nøkkel-verdi-par å samsvare med.
totalonlybool(Valgfritt) Hvis sann returneres kun totalt antall filer som samsvarer med spørringen.
ids_onlybool(Valgfritt) Hvis sann returneres kun publiserte fil-ID-er for filer som samsvarer med spørringen.
return_vote_databoolReturner avstemningsdata.
return_tagsboolReturner merkelapper i fildetaljene.
return_kv_tagsboolReturner nøkkel-verdi-merkelapper i fildetaljene.
return_previewsboolReturner informasjon om forhåndsvisningsbilde og -video i fildetaljene.
return_childrenboolReturner ID-er til underordnede gjenstander i fildetaljene.
return_short_descriptionboolFyll ut feltet short_description istedenfor file_description.
return_for_sale_databoolReturner prisinformasjon hvis aktuelt.
return_metadataboolFyll ut metadata.
return_playtime_statsuint32Returner spilletidsstatistikk for angitt antall dager før i dag.

Utfører en spørring etter publiserte filer.
MERK: Du kan spørre med parametrene «filetype» (IPublishedFileService#EPublishedFileInfoMatchingFileType), men resultatene innholder en «file_type»-verdi. Verdien samvarer med ISteamRemoteStorage#EWorkshopFileType.

SetDeveloperMetadata

POST https://partner.steam-api.com/IPublishedFileService/SetDeveloperMetadata/v1/
NavnTypePåkrevdBeskrivelse
keystringUtgivernøkkel for nett-API-et til Steamworks.
publishedfileiduint64
appiduint32
metadatastring

Angir metadata for utvikleren på den publiserte filen.

MERK: Dette kallet krever en utgiver-API-nøkkel for å bruke denne metoden. Dette API-et kalles fra en sikker tjener, og kan aldri brukes direkte av klienten!

UpdateAppUGCBan

POST https://partner.steam-api.com/IPublishedFileService/UpdateAppUGCBan/v1/
NavnTypePåkrevdBeskrivelse
keystringUtgivernøkkel for nett-API-et til Steamworks.
steamiduint64Steam-ID-en til brukeren.
appiduint32
expiration_timeuint32Unix-tidsstempel når utestengelsen utløper – 0 for å fjerne.
reasonstringGrunnen til at brukeren ble utestengt. Vises til brukeren.

Legger til, oppdaterer eller fjerner en brukers utestengelse fra brukerskapt innhold i applikasjonen. Angi expiration_time som 0 for å fjerne utestengelsen.

MERK: Dette kallet krever en API-utgivernøkkel for å bruke denne metoden. Derfor dette API-et kalles fra en sikker tjener og kan aldri brukes direkte av klienter!

UpdateBanStatus

POST https://partner.steam-api.com/IPublishedFileService/UpdateBanStatus/v1/
NavnTypePåkrevdBeskrivelse
keystringUtgivernøkkel for nett-API-et til Steamworks.
publishedfileiduint64
appiduint32
bannedbool
reasonstringGrunnen til at gjenstanden ble utestengt. Kun synlig for administratorer.

Oppdaterer utestengelsesstatusen på den publiserte filen.

MERK: Dette kallet krever en API-utgivernøkkel for å bruke denne metoden. Derfor dette API-et kalles fra en sikker tjener og kan aldri brukes direkte av klienter!

UpdateIncompatibleStatus

POST https://partner.steam-api.com/IPublishedFileService/UpdateIncompatibleStatus/v1/
NavnTypePåkrevdBeskrivelse
keystringUtgivernøkkel for nett-API-et til Steamworks.
publishedfileiduint64
appiduint32
incompatiblebool

Oppdaterer inkompatibilitetsstatusen på den publiserte filen. «Inkompatible» gjenstander skjules fra samfunnssentraler og brukerprofiler, men man har fremdeles tilgang med en direkte lenke.

MERK: Dette kallet krever en API-utgivernøkkel for å bruke denne metoden. Derfor dette API-et kalles fra en sikker tjener og kan aldri brukes direkte av klienter!

UpdateTags

POST https://partner.steam-api.com/IPublishedFileService/UpdateTags/v1/
NavnTypePåkrevdBeskrivelse
keystringUtgivernøkkel for nett-API-et til Steamworks.
publishedfileiduint64
appiduint32
add_tagsstringMerkelapper å legge til.
remove_tagsstringMerkelapper å fjerne.

Oppdaterer merkelapper på den publiserte filen. Eksisterende merkelapper fjernes ikke med mindre de angis i parameteren remove_tags.

MERK: Dette kallet krever en API-utgivernøkkel for å bruke denne metoden. Derfor dette API-et kalles fra en sikker tjener og kan aldri brukes direkte av klienter!

Oppramsinger (enum)

Dette er oppramsinger som defineres for bruk med ISteamRemoteStorage.

EPublishedFileQueryType

Måter man kan spørre etter brukerskapte gjenstander.

NavnVerdi
k_PublishedFileQueryType_RankedByVote0
k_PublishedFileQueryType_RankedByPublicationDate1
k_PublishedFileQueryType_AcceptedForGameRankedByAcceptanceDate2
k_PublishedFileQueryType_RankedByTrend3
k_PublishedFileQueryType_FavoritedByFriendsRankedByPublicationDate4
k_PublishedFileQueryType_CreatedByFriendsRankedByPublicationDate5
k_PublishedFileQueryType_RankedByNumTimesReported6
k_PublishedFileQueryType_CreatedByFollowedUsersRankedByPublicationDate7
k_PublishedFileQueryType_NotYetRated8
k_PublishedFileQueryType_RankedByTotalUniqueSubscriptions9
k_PublishedFileQueryType_RankedByTotalVotesAsc10
k_PublishedFileQueryType_RankedByVotesUp11
k_PublishedFileQueryType_RankedByTextSearch12
k_PublishedFileQueryType_RankedByPlaytimeTrend13
k_PublishedFileQueryType_RankedByTotalPlaytime14
k_PublishedFileQueryType_RankedByAveragePlaytimeTrend15
k_PublishedFileQueryType_RankedByLifetimeAveragePlaytime16
k_PublishedFileQueryType_RankedByPlaytimeSessionsTrend17
k_PublishedFileQueryType_RankedByLifetimePlaytimeSessions18
k_PublishedFileQueryType_RankedByInappropriateContentRating19
k_PublishedFileQueryType_RankedByBanContentCheck20
k_PublishedFileQueryType_RankedByLastUpdatedDate21

EPublishedFileInfoMatchingFileType

Måten en delt fil kan spørres med QueryFile.

NavnVerdiBeskrivelse
k_PFI_MatchingFileType_Items0Gjenstander.
k_PFI_MatchingFileType_Collections1En samling med workshopgjenstander.
k_PFI_MatchingFileType_Art2Kunstverk.
k_PFI_MatchingFileType_Videos3Videoer.
k_PFI_MatchingFileType_Screenshots4Skjermbilder.
k_PFI_MatchingFileType_CollectionEligible5Gjenstander som kan legges i en samling.
k_PFI_MatchingFileType_Games6Ikke i bruk.
k_PFI_MatchingFileType_Software7Ikke i bruk.
k_PFI_MatchingFileType_Concepts8Ikke i bruk.
k_PFI_MatchingFileType_GreenlightItems9Ikke i bruk.
k_PFI_MatchingFileType_AllGuides10Veiledninger.
k_PFI_MatchingFileType_WebGuides11Nettveiledning på Steam.
k_PFI_MatchingFileType_IntegratedGuides12Integrert veiledning i applikasjonen.
k_PFI_MatchingFileType_UsableInGame13
k_PFI_MatchingFileType_Merch14Workshopvarer som kan stemmes på, med mål om å selges.
k_PFI_MatchingFileType_ControllerBindings15Kontrollerbindinger på Steam.
k_PFI_MatchingFileType_SteamworksAccessInvites16Brukes internt.
k_PFI_MatchingFileType_Items_Mtx17Workshopgjenstander som kan selges i spillet.
k_PFI_MatchingFileType_Items_ReadyToUse18Workshopgjenstander som kan brukes med en gang av brukeren.
k_PFI_MatchingFileType_WorkshopShowcase19
k_PFI_MatchingFileType_GameManagedItems20Behandles fullstendig av spillet – ikke brukeren – og vises ikke på nett.