Google Play Developer API . edits . tracks

Instance Methods

get(packageName, editId, track)

Fetches the track configuration for the specified track type. Includes the APK version codes that are in this track.

list(packageName, editId)

Lists all the track configurations for this edit.

patch(packageName, editId, track, body)

Updates the track configuration for the specified track type. This method supports patch semantics.

update(packageName, editId, track, body)

Updates the track configuration for the specified track type.

Method Details

get(packageName, editId, track)
Fetches the track configuration for the specified track type. Includes the APK version codes that are in this track.

Args:
  packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required)
  editId: string, Unique identifier for this edit. (required)
  track: string, The track to read or modify. (required)

Returns:
  An object of the form:

    {
      "track": "A String", # Identifier for this track.
      "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes.
        {
          "status": "A String", # The desired status of this release.
          "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs.
          "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases.
            "A String",
          ],
          "releaseNotes": [ # The description of what is new in the app in this release.
            {
              "text": "A String", # The text in the given `language`.
              "language": "A String", # The language code, in BCP 47 format (eg "en-US").
            },
          ],
          "countryTargeting": {
            "includeRestOfWorld": True or False,
            "countries": [
              "A String",
            ],
          },
          "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted".
        },
      ],
    }
list(packageName, editId)
Lists all the track configurations for this edit.

Args:
  packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required)
  editId: string, Unique identifier for this edit. (required)

Returns:
  An object of the form:

    {
    "kind": "androidpublisher#tracksListResponse", # Identifies what kind of resource this is. Value: the fixed string "androidpublisher#tracksListResponse".
    "tracks": [
      {
          "track": "A String", # Identifier for this track.
          "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes.
            {
              "status": "A String", # The desired status of this release.
              "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs.
              "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases.
                "A String",
              ],
              "releaseNotes": [ # The description of what is new in the app in this release.
                {
                  "text": "A String", # The text in the given `language`.
                  "language": "A String", # The language code, in BCP 47 format (eg "en-US").
                },
              ],
              "countryTargeting": {
                "includeRestOfWorld": True or False,
                "countries": [
                  "A String",
                ],
              },
              "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted".
            },
          ],
        },
    ],
  }
patch(packageName, editId, track, body)
Updates the track configuration for the specified track type. This method supports patch semantics.

Args:
  packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required)
  editId: string, Unique identifier for this edit. (required)
  track: string, The track to read or modify. (required)
  body: object, The request body. (required)
    The object takes the form of:

{
    "track": "A String", # Identifier for this track.
    "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes.
      {
        "status": "A String", # The desired status of this release.
        "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs.
        "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases.
          "A String",
        ],
        "releaseNotes": [ # The description of what is new in the app in this release.
          {
            "text": "A String", # The text in the given `language`.
            "language": "A String", # The language code, in BCP 47 format (eg "en-US").
          },
        ],
        "countryTargeting": {
          "includeRestOfWorld": True or False,
          "countries": [
            "A String",
          ],
        },
        "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted".
      },
    ],
  }


Returns:
  An object of the form:

    {
      "track": "A String", # Identifier for this track.
      "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes.
        {
          "status": "A String", # The desired status of this release.
          "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs.
          "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases.
            "A String",
          ],
          "releaseNotes": [ # The description of what is new in the app in this release.
            {
              "text": "A String", # The text in the given `language`.
              "language": "A String", # The language code, in BCP 47 format (eg "en-US").
            },
          ],
          "countryTargeting": {
            "includeRestOfWorld": True or False,
            "countries": [
              "A String",
            ],
          },
          "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted".
        },
      ],
    }
update(packageName, editId, track, body)
Updates the track configuration for the specified track type.

Args:
  packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required)
  editId: string, Unique identifier for this edit. (required)
  track: string, The track to read or modify. (required)
  body: object, The request body. (required)
    The object takes the form of:

{
    "track": "A String", # Identifier for this track.
    "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes.
      {
        "status": "A String", # The desired status of this release.
        "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs.
        "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases.
          "A String",
        ],
        "releaseNotes": [ # The description of what is new in the app in this release.
          {
            "text": "A String", # The text in the given `language`.
            "language": "A String", # The language code, in BCP 47 format (eg "en-US").
          },
        ],
        "countryTargeting": {
          "includeRestOfWorld": True or False,
          "countries": [
            "A String",
          ],
        },
        "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted".
      },
    ],
  }


Returns:
  An object of the form:

    {
      "track": "A String", # Identifier for this track.
      "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes.
        {
          "status": "A String", # The desired status of this release.
          "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs.
          "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases.
            "A String",
          ],
          "releaseNotes": [ # The description of what is new in the app in this release.
            {
              "text": "A String", # The text in the given `language`.
              "language": "A String", # The language code, in BCP 47 format (eg "en-US").
            },
          ],
          "countryTargeting": {
            "includeRestOfWorld": True or False,
            "countries": [
              "A String",
            ],
          },
          "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted".
        },
      ],
    }