content publish api reference this page lists the parameters, country codes, and language codes used with the view seller’s app details response and modify app data request in the content publish api [ { "contentid" "000007654321", "apptitle" "the best app ever!", "icon" "https //img samsungapps com/content/d33aazz11a/2021/0214/iconimage_20210214000000000 png", "iconkey" null, "contentstatus" "registering", "defaultlanguagecode" "eng", "applicationtype" "android", "longdescription" "the app that solves all your problems ", "shortdescription" "", "newfeature" "", "agelimit" "0", "chinaagelimit" "0", "opensourceurl" "", "privatepolicyurl" "", "youtubeurl" "", "copyrightholder" "", "supportemail" "support@mycompany com", "supportedsiteurl" "", "binarylist" [ { "filename" "app_filename apk", "versioncode" "3", "versionname" "3", "packagename" "my package name", "nativeplatforms" null, "apiminsdkversion" "26", "apimaxsdkversion" null, "iapsdk" "n", "gms" "y", "filekey" null } ], "standardprice" "0", "paid" "n", "autoaddcountry" false, "publicationtype" "01", "startpublicationdate" null, "stoppublicationdate" "2023-01-02", "usexportlaws" true, "reviewcomment" null, "reviewfilename" null, "reviewfilekey" null, "edgescreen" null, "edgescreenkey" null, "edgescreenplus" null, "edgescreenpluskey" null, "notifyresult" [], "sellcountrylist" [ {"countrycode" "aut", "price" "0"}, {"countrycode" "deu", "price" "0"}, {"countrycode" "esp", "price" "0"}, {"countrycode" "fra", "price" "0"}, {"countrycode" "ita", "price" "0"}, {"countrycode" "jpn", "price" "0"}, {"countrycode" "kor", "price" "0"}, {"countrycode" "nld", "price" "0"}, {"countrycode" "tur", "price" "0"} ], "supportedlanguages" ["deu", "eng", "fra", "ita", "jpn", "kor"], "addlanguage" [ { "languagecode" "deu", "newfeature" "", "description" "the app that solves all your problems ", "apptitle" "the best app ever!", "screenshots" [ { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_202102230000000002 png", "screenshotkey" "screenimage_202102230000000002_filekey", "reuseyn" false }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_2021022300000000 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_20210223000000009 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_202102230000000001 jpeg", "screenshotkey" null, "reuseyn" true } ] } ], "screenshots" [ { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000000 png", "screenshotkey" "screenimage_20210218000000000_filekey", "reuseyn" false }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000001 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000002 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000003 png", "screenshotkey" null, "reuseyn" true } ], "category" [ { "name" "others", "type" "one_depth_category" }, { "name" "music", "type" "general_category" } ], "heroimage" "https //img samsungapps com/content/d33aazz11a/2021/0219/eng/coverimage_20210219000000007 png", "heroimagekey" null } ] general parameters name type description addlanguage addlanguage[] add local languages in which you want to provide application information dismiss when null is entered neither add nor delete content , remove all when an empty distribution is entered see addlanguage parameters agelimit int the samsung age rating of the app see age category under age rating for more information valid values 0, 4, 12, 16, 18 chinaagelimit string age restriction for china required value if any of the code values in the defaultlanguagecode or addlanguage list are in chinese valid values 0, 3, 8, 12, 16, 18 apptitle string the name of the app that is displayed in your galaxy store listing maximum 100 bytes the app title can be unique or the same as any other app title registered in seller portal or distributed in galaxy store per the app id policy, if you register an app title with an app id that are the same title and id of a previously registered app, then you cannot choose the distribution devices and countries as the previously registered app autoaddcountry boolean automatically distribute the app to a new country or group when it initially becomes available y distribute your app to a new country or group n do not distribute your app to a new country or group binarylist binaryinfo[] dismiss when null is entered neither add nor delete content , remove all when an empty distribution is entered see binarylist parameters category category[] one or more app store groups that best describe the app see category parameters cannot be modified contentid string required in a request the unique 12-digit identifier of the app copyrightholder string for apps that have copyrighted content, the name of the copyright holder of the app maximum 100 bytes if a company is the holder, enter the company name if an individual is the holder, enter the individual's name when specified, the copyright holder's name is displayed in the galaxy store listing instead of the seller's name when not specified, the seller's name is displayed as the copyright holder defaultlanguagecode string required in a request the language in which you provide application information see language codes for addlanguage and defaultlanguagecode for a list of supported languages note if the app is published in more than one country, in order to pass app review, this must be set to "eng" edgescreen image file name of the image file app icon or logo file that must be a png file, 160x2560 pixels, and up to 1024 kb edgescreenkey string the filekey associated with the uploaded file in a request, you must create a session id and then upload the file to obtain the filekey edgescreenplus image file name of the image file app icon or logo file that must be a png file, 550x2560 pixels, and up to 1024 kb edgescreenpluskey string the filekey associated with the uploaded file in a request, you must create a session id and then upload the file to obtain the filekey heroimage image file name of the image file in some countries, the image file displayed at the top of the app detail page jpg or png file, 1200x675 pixels, and up to 1024 kb you can use this field if you select a category name of games heroimagekey string the filekey associated with the uploaded file in a request, you must create a session id and then upload the file to obtain the filekey icon image file name of the image file app icon or logo file for an android app, it must be a png file, 512x512 pixels, and up to 1024 kb iconkey string the filekey associated with the uploaded file in a request, you must create a session id and then upload the file to obtain the filekey longdescription string explanation of the app including a description, features, requirements, and supported languages that is displayed in your galaxy store listing maximum 4000 bytes if the app has two or more distribution countries, the description must be in english for non-english apps, the description must contain a warning stating that the full features of the application may not be available on devices that do not support the app's languages for link-follower galaxy watch apps, the description must inform users that the linked app must be installed newfeature string explanation of the changes made to an updated app maximum 4000 bytes use this field if the app is being updated notifyresult string[] email address es that are notified when the status of the app registration changes maximum 20 email addresses opensourceurl string for apps that use or include open source software, the url of the open source license maximum 200 bytes paid boolean required in a request whether or not app download requires a user payment y users must pay to download the app n the app is free, users can download it without payment privatepolicyurl string for apps that have a privacy policy that require a separate notification, the url of the app privacy policy maximum 200 bytes if a privacy policy is not specified, the category may be changed during certification required if the kids category is selected optional for all other app categories publicationtype string required in a request when the app is published 01 publish automatically publishes the app after the pre-review phase has completed 02 publish on date when the app has passed the pre-review phase, the app sale starts automatically on the date specified by startpublicationdate 03 publish manually the seller must publish the app after all phases of the review process have successfully completed reviewcomment string information to help with the evaluation of the app to determine whether or not the app is to be distributed maximum 4000 bytes reviewfilekey string the filekey associated with the uploaded file in a request, you must create a session id and then upload the file to obtain the filekey screenshots screenshot[] dismiss when null is entered neither add nor delete content , remove all when empty distribution is entered see screenshots parameters sellcountrylist sellcountry[] countries and groups of countries to which the app is to be distributed dismiss when null is entered neither add nor delete content , remove all when empty distribution is entered see sellcountrylist parameters shortdescription string brief explanation of the app displayed in the chinese galaxy store listing maximum 40 bytes use this field if simplified chinese is one of your selected languages standardprice string standard price in usd united states of america dollars that determines the default country-specific price for all distribution countries startpublicationdate string enter as yyyy-mm-dd hh mm ss when distribution of the app in galaxy store begins when publicationtype is set to 02 stoppublicationdate string enter as yyyy-mm-dd when distribution of the app in galaxy store stops supportedlanguages string[] one or more languages that the app presents graphically or audibly in its ux, instructions, or other ways communicating to users see language codes for supportedlanguages for a list of supported languages supportemail string email address of the person to whom app end-users can send inquiries maximum 100 bytes supportedsiteurl string url of the available end-user support site for the app maximum 200 bytes usexportlaws boolean whether or not you certify that the app is in compliance with all applicable u s export laws for export to other countries y you certify your app is in compliance n you do not certify your app if your app is not in compliance, it cannot be submitted for validation and distribution youtubeurl string youtube video id of a youtube video related to the app 11 characters the initial screenshot and hyperlink of the video is automatically displayed in the first screenshot location of the galaxy store listing addlanguage parameters "addlanguage" [ { "languagecode" "deu", "newfeature" "", "description" "the app that solves all your problems ", "apptitle" "the best app ever!", "screenshots" [ { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_202102230000000002 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_2021022300000000 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_20210223000000009 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_202102230000000001 jpeg", "screenshotkey" null, "reuseyn" true } ] } ] name type description languagecode string required if you are updating addlanguage add a language in which you want to provide application information see language codes for addlanguage and defaultlanguagecode for a list of supported languages newfeature string explanation of the changes made to an updated app maximum 4000 bytes description string required if you are updating addlanguage explanation of the app including a description, features, requirements, and supported languages that is displayed in your galaxy store listing maximum 4000 bytes for non-english apps, the description must contain a warning stating that the full features of the application may not be available on devices that do not support the app's languages for link-follower galaxy watch apps, the description must inform users that the linked app must be installed apptitle string required if you are updating addlanguage the name of the app in the selected language that is displayed in your listing of a galaxy store that supports the language screenshots screenshot[] dismiss when null is entered, remove all when an empty distribution is entered see screenshots parameters to remove all content from this parameter, leave it blank in the request for example, "addlanguage" "" to keep the existing content for this parameter neither add nor delete content , set it to null for example, "addlanguage" "null" binarylist parameters "binarylist" [ { "filename" "app_filename apk", "binaryseq" "1", "versioncode" "3", "versionname" "3", "packagename" "my package name", "nativeplatforms" null, "apiminsdkversion" "26", "apimaxsdkversion" null, "iapsdk" "n", "gms" "y", "filekey" null } ] name type description apimaxsdkversion int the maximum api level or os version supported by the binary file apiminsdkversion int the minimum api level or os version supported by the binary file binaryseq int required when changing existing binary data copy the value from the contentinfo response this value is not visible in seller portal filekey string required for new registration or replacement of a binary file the filekey associated with the uploaded file in a request, you must create a session id and then upload the file to obtain the filekey filename string name of the binary file gms boolean required if you are updating binarylist whether or not the app provides the user with any google™ services such as google maps™, gmail™, and talk y the app provides one or more google services n the app does not provide any google services the distribution of an app that provides the user with any google services is prohibited in some countries such as china and is automatically enforced by seller portal when registering a new version of a binary file, this setting can be changed, if needed iapsdk boolean whether or not the app provides in-app purchase items using samsung in-app purchase iap sdk y the app uses samsung iap n the app does not use samsung iap nativeplatforms string supported architecture information valid values null, 32bit, 32/64bit, or 64bit packagename string the app id maximum 1,000 bytes versioncode string integer value that represents the version of the app code in the binary file relative to other versions versionname string the release version of the app code in the binary file that is displayed in galaxy store to add a new binary to your app, append a new set of the parameters to the existing binarylist you can register up to 10 binary files and the extensions of all binaries registered for an app must be identical to remove all content from this parameter, leave it blank in the request for example, "binarylist" "" to keep the existing content for this parameter neither add nor delete content , set it to null for example, "binarylist" "null" for example, to add a new binary, if this is the binarylist in the contentinfo response "binarylist" [ { "filename" "app_filename apk", "binaryseq" "1", "versioncode" "3", "versionname" "3", "packagename" "my package name", "nativeplatforms" null, "apiminsdkversion" "26", "apimaxsdkversion" null, "iapsdk" "n", "gms" "y", "filekey" null } ] change the binarylist parameter to this in the request to add the new binary uploaded with the fileupload api "binarylist" [ { "filename" "app_filename apk", "binaryseq" "1", "versioncode" "3", "versionname" "3", "packagename" "my package name", "nativeplatforms" null, "apiminsdkversion" "26", "apimaxsdkversion" null, "iapsdk" "n", "gms" "y", "filekey" null }, { "binaryseq" "2", "gms" "y", "filekey" "<new-binary-filekey>" } ] or, to replace the existing binary instead of appending a new one "binarylist" [ { "binaryseq" "1", "gms" "y", "filekey" "<new-binary-filekey>" } ] see app binary registration for more details category parameters "category" [ { "name" "others", "type" "one_depth_category" }, { "name" "music", "type" "general_category" } ] name type description name string one or more app store groups that best describe the app available categories and sub-categories depend on the platform, binary files, permissions, and other factors unless governed by distribution country requirements, the app is listed in galaxy store under one or both categories and sub-categories if the category selected is not suitable for the application, it may be changed automatically select from one of the following kids, games, travel, social, music, decoration, office, photo, book, lifestyle, tool, video, system, finance, shopping, education, or traffic health type string required if a name is specified that has a subcategory see next table one or more app store sub-groups that best describe the app category name sub-category type kids valid values play, learning, story games valid values puzzle, online game, action/adventure, shooting, racing, strategy, board, role playing, arcade, card, casino, casual, music, simulation, sports, trivia, wordby selecting a specific game sub-category arcade, card, casino, casual, music, simulation, sports, trivia, word , you are not allowed to select china for the country of sale screenshots parameters "screenshots" [ { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_202102230000000002 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_2021022300000000 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_20210223000000009 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0223/deu/screenimage_202102230000000001 jpeg", "screenshotkey" null, "reuseyn" true } ] name type description screenshotpath image file image file of app screenshot to be displayed in your galaxy store listing jpg or png file, 320-3840 pixels with a maximum 2 1 aspect ratio you must register 4-8 screenshots if more than eight screenshots are uploaded, only the first eight images are displayed if you register a link to a youtube video, a screenshot of the video and the link is displayed automatically in the first screenshot location of the galaxy store listing screenshotkey string set to null if you are re-using the same screenshot if you want to replace the screenshot, set this to the image filekey create a session id and then upload the file to obtain the filekey and set the reuseyn parameter to false reuseyn boolean required if you are updating screenshots whether you want to continue using the existing screenshot true re-use the screenshot false replace the screenshot enter the filekey to the image using the screenshotkey parameter to remove all content from this parameter, leave it blank in the request for example, "screenshots" "" to keep the existing content for this parameter neither add nor delete content , set it to null for example, "screenshots" "null" if you want to remove one or more screenshots, remove it from the request parameters for example, if these are the screenshots parameters in the contentinfo response "screenshots" [ { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000000 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000001 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000002 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000003 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000004 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000005 png", "screenshotkey" null, "reuseyn" true } ] to remove the last two screenshots, change the screenshots parameters to this in the request "screenshots" [ { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000000 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000001 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000002 png", "screenshotkey" null, "reuseyn" true }, { "screenshotpath" "https //img samsungapps com/content/d33aazz11a/2021/0218/eng/screenimage_20210218000000003 png", "screenshotkey" null, "reuseyn" true } ] sellcountrylist parameters "sellcountrylist" [ {"countrycode" "aut", "price" "0"}, {"countrycode" "deu", "price" "0"}, {"countrycode" "esp", "price" "0"} ] name type description countrycode string required if you are updating sellcountrylist countries and groups of countries to which the app is to be distributed see country codes for sellcountrylist for the list of country codes price double country-specific price in the local currency the price must fall within the minimum and maximum allowable price for the country, if applicable prices may vary by country see entering information on country/region and price for more details to remove all content from this parameter, leave it blank in the request for example, "sellcountrylist" "" to keep the existing content for this parameter neither add nor delete content , set it to null for example, "sellcountrylist" "null" country codes for sellcountrylist sorted by region, then alphabetically by country name europe "aut" "austria", "bel" "belgium", "bgr" "bulgaria", "hrv" "croatia", "cze" "czech", "dnk" "denmark", "est" "estonia", "fin" "finland", "fra" "france", "deu" "germany", "grc" "greece", "hun" "hungary", "irl" "ireland", "ita" "italy", "lva" "latvia", "ltu" "lithuania", "lux" "luxembourg", "nld" "netherlands", "nor" "norway", "pol" "poland", "prt" "portugal", "rou" "romania", "srb" "serbia", "svk" "slovakia", "esp" "spain", "swe" "sweden", "che" "switzerland", "tur" "turkey", "gbr" "united kingdom" cis "blr" "belarus", "kaz" "kazakhstan", "rus" "russia", "ukr" "ukraine" asia "aus" "australia", "chn" "chinese", "hkg" "chinese hong kong", "twn" "chinese taiwan", "ind" "india", "idn" "indonesia", "jpn" "japan", "kor" "korea", "mys" "malaysia", "nzl" "new zealand", "phl" "philippines", "sgp" "singapore", "tha" "thailand", "vnm" "vietnam" america "arg" "argentina", "bra" "brazil", "can" "canada", "chl" "chile", "col" "colombia", "mex" "mexico", "per" "peru", "usa" "usa" middle east and africa "dza" "algeria", "bhr" "bahrain", "egy" "egypt", "irn" "iran", "irq" "iraq", "isr" "israel", "jor" "jordan", "kwt" "kuwait", "lbn" "lebanon", // only free applications are available "lby" "libya", "mar" "morocco", "omn" "oman", "qat" "qatar", "sau" "saudi arabia", "zaf" "south africa", "tun" "tunisia", "are" "united arab emirates", "yem" "yemen" groups "glb" "global a", "glf" "global a free", // only free applications are available "isu" "global free", // only free applications are available "gpb" "pan latin free", // only free applications are available "gpf" "pan-africa english ", // only free applications are available "gpa" "pan-africa french ", // only free applications are available "gpl" "pan-latin" "bts" "beta test store" // only free applications are available language codes for addlanguage and defaultlanguagecode sorted alphabetically by language "ara" "arabic", "bul" "bulgarian", "zho" "chinese simplified", "002" "chinese traditional", "hrv" "croatian", "ces" "czech", "dan" "danish", "nld" "dutch", "eng" "english", "est" "estonian", "fin" "finnish", "fra" "french", "gla" "gaelic", "deu" "german", "ell" "greek", "heb" "hebrew", "hun" "hungarian", "ind" "indonesian", "ita" "italian", "jpn" "japanese", "kaz" "kazakh", "kor" "korean", "lav" "latvian", "lit" "lithuanian", "nor" "norwegian", "fas" "persian", "pol" "polish", "por" "portuguese", "ron" "romanian", "rus" "russian", "srp" "serbian", "slk" "slovakian", "spa" "spanish", "swe" "swedish", "tha" "thai", "tur" "turkish", "ukr" "ukrainian", "vie" "vietnamese" language codes for supportedlanguages sorted alphabetically by language "ara" "arabic", "hye" "armenian", "asn" "assamese", "aze" "azerbaijani", "eus" "basque", "ben" "bengali", "bul" "bulgarian", "cat" "catalan", "zho" "chinese simplified", "002" "chinese traditional", "hrv" "croatian", "ces" "czech", "dan" "danish", "nld" "dutch", "eng" "english", "est" "estonian", "fas" "farsi", "fin" "finnish", "fra" "french", "glg" "galician", "kat" "georgian", "deu" "german", "ell" "greek", "guj" "gujarati", "hau" "hausa", "heb" "hebrew", "hin" "hindi", "hun" "hungarian", "isl" "icelandic", "ibo" "igbo", "ind" "indonesian", "gle" "irish", "ita" "italian", "jpn" "japanese", "kan" "kannada", "kaz" "kazakh", "khm" "khmer", "kor" "korean", "lao" "lao", "lav" "latvian", "lit" "lithuanian", "mkd" "macedonian", "msa" "malay", "mal" "malayalam", "mar" "marathi", "mon" "mongolian", "bur" "myanmar", "nep" "nepali", "nor" "norwegian", "ori" "oriya", "pol" "polish", "por" "portuguese", "pan" "punjabi", "ron" "romanian", "rus" "russian", "srp" "serbian", "sin" "sinhala", "slk" "slovakian", "slv" "slovenian", "spa" "spanish", "lat" "spanish_latin", "swe" "swedish", "tam" "tamil", "tel" "telugu", "tha" "thai", "tur" "turkish", "ukr" "ukrainian", "urd" "urdu", "uzb" "uzbek", "vie" "vietnamese", "yor" "yoruba"
