با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
روش‌های ویرایش برنامه‌نویس Google Play Publishing API به شما این امکان را می‌دهد که تعدادی از تغییرات را در برنامه Google Play خود آماده کنید، سپس همه آنها را به یکباره اجرا کنید. شما این کار را با ایجاد یک ویرایش انجام می‌دهید، که تمام تغییراتی را که می‌خواهید در برنامه ایجاد کنید نگه می‌دارد. این ویرایش حاوی اطلاعاتی مانند موارد زیر است:
کدام فایل‌های APK با برنامه مرتبط هستند و یک «آهنگ» برای هر APK.
هر کدام با یک "آهنگ" مرتبط است که تعیین می کند کدام کاربران آن را ببینند. این به شما امکان می دهد نسخه های آلفا و بتا برنامه را برای آزمایش کنندگان خود ارائه دهید. علاوه بر این، می‌توانید نسخه‌ای از برنامه را با انتشار محدود ارائه دهید. این برنامه به طور خودکار به تعداد محدودی از کاربران برنامه ارائه می شود (که بر اساس درصد عرضه ای که تعیین کرده اید تعیین می شود) و به شما امکان می دهد نسخه تولیدی جدید برنامه را به تدریج اجرا کنید.
نسخه‌های زبان و مکان خاص فهرست‌بندی فروشگاه Google Play برنامه
هر نسخه خاص از فهرست فروشگاه می‌تواند حاوی اسکرین‌شات‌ها و سایر گرافیک‌های تبلیغاتی، متن توصیفی بومی‌شده و غیره باشد.
هنگامی که برای اولین بار ویرایشی را ایجاد می کنید، ویرایش یک کپی از وضعیت فعلی برنامه است. سپس می‌توانید با فراخوانی روش‌های ویرایش، ویرایش را تغییر دهید. هنگامی که ویرایش آماده انجام شد، آن را انجام می دهید و تغییرات را به صورت زنده انجام می دهید. همچنین می‌توانید هر زمان که بخواهید ویرایش را رها کنید، تغییرات را نادیده بگیرید و برنامه‌تان را همانطور که بود رها کنید.
شما فقط می توانید از این API برای ایجاد تغییرات در یک برنامه موجود (که حداقل یک APK آپلود شده است) استفاده کنید. بنابراین، قبل از اینکه بتوانید از این API استفاده کنید، باید حداقل یک APK را از طریق کنسول Play آپلود کنید. علاوه بر این، نمی‌توانید از این API برای تغییر وضعیت برنامه از «منتشرشده» به «منتشر نشده» یا تکمیل رضایت‌های قانونی مورد نیاز برای انتشار استفاده کنید. برای انتشار برنامه، باید از کنسول Play استفاده کنید.
جریان کار
این بخش روش معمولی استفاده از روش‌های ویرایش‌های API انتشار برنامه‌نویس Google Play را برای ایجاد تغییرات در یک برنامه نشان می‌دهد.
این یک ویرایش جدید از برنامه مشخص شده ایجاد می کند. تنظیمات اولیه برنامه - فایل‌های APK، فهرست‌های فروشگاه، فایل‌های توسعه‌دهنده و غیره- همگی از نسخه نصب‌شده برنامه کپی می‌شوند.
ویرایش را به دلخواه تغییر دهید.
شما می توانید بیشتر تغییراتی را که می توانید از طریق کنسول Google Play انجام دهید، انجام دهید. این کار را با فراخوانی متد مناسب Google Play Developer API و ارسال شناسه‌های برنامه و ویرایشی که می‌خواهید تغییر دهید، انجام می‌دهید. به طور مشخص:
می‌توانید فایل‌های APK جدید را با تماس با Edits.apks: آپلود آپلود کنید. این APK را در یک فضای ذخیره سازی قرار می دهد، بنابراین می توان آن را به یک آهنگ در این ویرایش یا ویرایش بعدی اختصاص داد.
با تماس با Edits.tracks: update می‌توانید فایل‌های APK را به آهنگ‌ها اختصاص دهید. همچنین می‌توانید با تماس با Edits.tracks: patch، تخصیص آهنگ‌ها را برای فایل‌های APK موجود تغییر دهید.
این روش‌ها تغییراتی را در ویرایشی که در حال انجام دارید ایجاد می‌کنند، اما نسخه زنده برنامه را تغییر نمی‌دهند . می‌توانید بدون تأثیرگذاری بر تجربه کاربر، تغییرات بیشتری ایجاد کنید یا از ویرایش در حال انجام صرف‌نظر کنید.
ویرایش را انجام دهید.
وقتی Edits: commit را فرا می‌خوانید، اگر هیچ خطای اعتبارسنجی وجود نداشته باشد، تمام تغییرات مشخص‌شده در منبع ویرایش‌ها به حالت "زنده" می‌شوند و جایگزین وضعیت فعلی برنامه می‌شوند. اعمال این تغییرات ممکن است چندین ساعت طول بکشد، درست مانند زمانی که تغییرات را از طریق کنسول Play ایجاد می کنید.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Google Play Developer Publishing API allows you to make changes to your app, such as updating APKs, store listings, and expansion files, using the "edits" functionality where you prepare changes in an edit and deploy them all at once by committing the edit.\u003c/p\u003e\n"],["\u003cp\u003eEdits enable managing APKs and their tracks (alpha, beta, staged rollout, production) allowing for controlled releases to testers and users.\u003c/p\u003e\n"],["\u003cp\u003eStore listings can be localized with language-specific descriptions, screenshots, and promotional graphics using edits.\u003c/p\u003e\n"],["\u003cp\u003eWhen an edit is committed, changes go live and can take several hours to fully propagate, but before that, edits can be modified further or discarded without affecting the live app.\u003c/p\u003e\n"],["\u003cp\u003eEdits functionality does not cover in-app products, standard products, subscriptions, unpublishing apps, or managing legal consents, which require separate API calls or the Play Console.\u003c/p\u003e\n"]]],["The Google Play Developer Publishing API uses \"edits\" to manage app changes. You create an edit, which initially mirrors the live app, and then modify it by uploading APKs, assigning them to tracks (alpha, beta, staged rollout), and updating localized store listings. These changes are made to the edit, not the live app. Finally, you commit the edit to make the changes live or abandon the edit to discard them. Only one edit per app can be active and changes through the Play Console discard any existing edits.\n"],null,["# Edits\n\nThe Google Play Developer Publishing API [Edits methods](/android-publisher/api-ref/rest/v3/edits#METHODS_SUMMARY)\nallow you to prepare a number of\nchanges to your Google Play app, then deploy them all at once. You do\nthis by creating an **edit**, which holds all the changes you want to\nmake to the app. The edit holds such information as:\n\n- Which APKs are associated with the app, and a \"track\" for each APK.\n\n Each is associated with a \"track\", determining which users see\n it. This allows you to provide alpha and beta versions of the app\n for your testers. In addition, you can provide a limited-release\n \"staged rollout\" version of the app; this app is automatically\n served to a limited number of the app's users (determined by the\n rollout percentage you set), allowing you to deploy a new\n production version of the app gradually.\n- Language and locale-specific versions of the app's Google Play\n Store listing\n\n Each locale-specific version of the store listing can contain\n screenshots and other promotional graphics, localized descriptive\n text, and so on.\n\n| **Note:** Not all the methods provided by the Google Play Developer API use the new, transactional \"edits\" functionality. Methods for the [inappproducts](/android-publisher/api-ref/rest/v3/inappproducts), [products](/android-publisher/api-ref/rest/v3/purchases.products), and [subscriptions](/android-publisher/api-ref/rest/v3/purchases.subscriptions) resources take effect immediately, whether or not there is an open edit for the app. Each resource's API reference page notes specifically whether the methods for that resource use the \"edits\" model.\n\nWhen you first create an edit, the edit is a copy of the current\ndeployed state of the app. You can then modify the edit by calling the\nEdits methods. When the edit is ready to go, you commit it,\nmaking the changes live. You can also abandon the edit at any time,\ndiscarding the changes and leaving your app as it was.\n\nYou can only use this API to make changes to an *existing* app (that\nhas at least one APK uploaded); thus, you will have to upload at least\none APK through the Play Console before you can use this\nAPI. Furthermore, you cannot use this API to change an app's state\nfrom \"published\" to \"unpublished\", or to fill out the legal consents\nrequired for publishing. To publish the app, you have to use the\nPlay Console.\n| **Caution:** If anyone makes any changes to the app through the Google Play Console while you have an edit in progress, your edit is discarded and the Play Console changes take effect.\n\nWorkflow\n--------\n\nThis section shows the typical way you would use the Google Play Developer Publishing API\n[Edits methods](/android-publisher/api-ref/rest/v3/edits#METHODS_SUMMARY) to make modifications to an app.\n\n1. Create a new edit, by calling [Edits:\n Insert](/android-publisher/api-ref/rest/v3/edits/insert) and specifying the app you want\n to modify.\n\n This creates a new edit of the specified app. The app's initial\n settings--the APKs, store listings, expansion files, and so on--are all\n copied from the deployed version of the app.\n2. Modify the edit as desired.\n\n You can make most of the changes which could be made through the\n Google Play Console. You do this by calling the\n appropriate Google Play Developer API method, and passing the IDs of the app\n and edit you want to modify. Specifically:\n - You can upload new APKs by calling [Edits.apks:\n upload](/android-publisher/api-ref/rest/v3/edits.apks/upload). This puts the APK in a storage area, so it can be assigned to a track in this or a subsequent edit.\n - You can assign APKs to tracks by calling [Edits.tracks:\n update](/android-publisher/api-ref/rest/v3/edits.tracks/update). You can also change the track assignments for existing APKs by calling [Edits.tracks:\n patch](/android-publisher/api-ref/rest/v3/edits.tracks/patch).\n - You can create a new localized store listing by calling [Edits.listings:\n update](/android-publisher/api-ref/rest/v3/edits.listings/update). You can modify an existing store listing by calling [Edits.listings: patch](/android-publisher/api-ref/rest/v3/edits.listings/patch).\n - You can add or modify expansion files by calling the [Edits.expansionfiles resource](/android-publisher/api-ref/rest/v3/edits.expansionfiles) methods.\n\n These methods make changes to the edit you have in progress, but\n they do *not* modify the live version of the app. You can make\n further changes or discard the edit in progress without affecting\n the user experience.\n | **Note:** Each user may have only a single edit open at a time. If you create a new edit, any existing edit you may have open is invalidated. In addition, if anyone commits an edit or makes changes to an app through the Play Console, *all* other edits for the app (owned by any user) are invalidated. If you try to commit an invalid edit, the operation will throw an exception and have no effect.\n3. Commit the edit.\n\n When you call [Edits: commit](/android-publisher/api-ref/rest/v3/edits/commit), if there\n are no validation errors, then all the changes specified in the\n edits resource go \"live\", replacing the current state of the\n app. These changes can take several hours to take effect, just as\n when you make changes through the Play Console."]]
