Api roll 1: 2014-09-23

discovery/googleapis/androidpublisher__v2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/androidpublisher": {
                     "description": "View and manage your Google Play Android Developer account"
                 }
             }
         }
     },
     "basePath": "/androidpublisher/v2/applications/",
     "baseUrl": "https://www.googleapis.com/androidpublisher/v2/applications/",
     "batchPath": "batch",
     "canonicalName": "Android Publisher",
     "description": "Lets Android application developers access their Google Play accounts.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/android-publisher",
-    "etag": "\"uUWyYHXmEn-ab7WLvo8qNz2S8ws/tXT4pCufDuL1OYbmvPiKHbGGdkc\"",
+    "etag": "\"uUWyYHXmEn-ab7WLvo8qNz2S8ws/rvEzY_KAgBOlUM1lQqukKQLrl6Y\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/android-16.png",
         "x32": "https://www.google.com/images/icons/product/android-32.png"
     },
     "id": "androidpublisher:v2",
     "kind": "discovery#restDescription",
     "name": "androidpublisher",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 1968 matching lines @@
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel",
                             "scopes": [
                                 "https://www.googleapis.com/auth/androidpublisher"
                             ]
                         },
+                        "defer": {
+                            "description": "Defers a user's subscription purchase until a specified future expiration time.",
+                            "httpMethod": "POST",
+                            "id": "androidpublisher.purchases.subscriptions.defer",
+                            "parameterOrder": [
+                                "packageName",
+                                "subscriptionId",
+                                "token"
+                            ],
+                            "parameters": {
+                                "packageName": {
+                                    "description": "The package name of the application for which this subscription was purchased (for example, 'com.some.thing').",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "subscriptionId": {
+                                    "description": "The purchased subscription ID (for example, 'monthly001').",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "token": {
+                                    "description": "The token provided to the user's device when the subscription was purchased.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer",
+                            "request": {
+                                "$ref": "SubscriptionPurchasesDeferRequest"
+                            },
+                            "response": {
+                                "$ref": "SubscriptionPurchasesDeferResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/androidpublisher"
+                            ]
+                        },
                         "get": {
                             "description": "Checks whether a user's subscription purchase is valid and returns its expiry time.",
                             "httpMethod": "GET",
                             "id": "androidpublisher.purchases.subscriptions.get",
                             "parameterOrder": [
                                 "packageName",
                                 "subscriptionId",
                                 "token"
                             ],
                             "parameters": {
@@ skipping 16 matching lines @@
                                     "type": "string"
                                 }
                             },
                             "path": "{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}",
                             "response": {
                                 "$ref": "SubscriptionPurchase"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/androidpublisher"
                             ]
+                        },
+                        "refund": {
+                            "description": "Refunds a user's subscription purchase, but the subscription remains valid until its expiration time and it will continue to recur.",
+                            "httpMethod": "POST",
+                            "id": "androidpublisher.purchases.subscriptions.refund",
+                            "parameterOrder": [
+                                "packageName",
+                                "subscriptionId",
+                                "token"
+                            ],
+                            "parameters": {
+                                "packageName": {
+                                    "description": "The package name of the application for which this subscription was purchased (for example, 'com.some.thing').",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "subscriptionId": {
+                                    "description": "The purchased subscription ID (for example, 'monthly001').",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "token": {
+                                    "description": "The token provided to the user's device when the subscription was purchased.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund",
+                            "scopes": [
+                                "https://www.googleapis.com/auth/androidpublisher"
+                            ]
+                        },
+                        "revoke": {
+                            "description": "Refunds and immediately revokes a user's subscription purchase. Access to the subscription will be terminated immediately and it will stop recurring.",
+                            "httpMethod": "POST",
+                            "id": "androidpublisher.purchases.subscriptions.revoke",
+                            "parameterOrder": [
+                                "packageName",
+                                "subscriptionId",
+                                "token"
+                            ],
+                            "parameters": {
+                                "packageName": {
+                                    "description": "The package name of the application for which this subscription was purchased (for example, 'com.some.thing').",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "subscriptionId": {
+                                    "description": "The purchased subscription ID (for example, 'monthly001').",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "token": {
+                                    "description": "The token provided to the user's device when the subscription was purchased.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:revoke",
+                            "scopes": [
+                                "https://www.googleapis.com/auth/androidpublisher"
+                            ]
                         }
                     }
                 }
             }
         }
     },
     "revision": "20140813",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Apk": {
@@ skipping 211 matching lines @@
                         "$ref": "Price",
                         "description": "Region code, as defined by ISO 3166-2."
                     },
                     "description": "Prices per buyer region. None of these prices should be zero. In-app products can never be free.",
                     "type": "object"
                 },
                 "purchaseType": {
                     "description": "Purchase type enum value. Unmodifiable after creation.",
                     "type": "string"
                 },
+                "season": {
+                    "$ref": "Season",
+                    "description": "Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions."
+                },
                 "sku": {
                     "description": "The stock-keeping-unit (SKU) of the product, unique within an app.",
                     "type": "string"
                 },
                 "status": {
                     "type": "string"
                 },
                 "subscriptionPeriod": {
                     "description": "The period of the subscription (if any), i.e. period at which payments must happen. Defined as ISO 8601 duration, i.e. \"P1M\" for 1 month period.",
                     "type": "string"
@@ skipping 176 matching lines @@
                 },
                 "listings": {
                     "items": {
                         "$ref": "Listing"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "MonthDay": {
+            "id": "MonthDay",
+            "properties": {
+                "day": {
+                    "description": "Day of a month, value in [1, 31] range. Valid range depends on the specified month.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "month": {
+                    "description": "Month of a year. e.g. 1 = JAN, 2 = FEB etc.",
+                    "format": "uint32",
+                    "type": "integer"
+                }
+            },
+            "type": "object"
+        },
         "PageInfo": {
             "id": "PageInfo",
             "properties": {
                 "resultPerPage": {
                     "format": "int32",
                     "type": "integer"
                 },
                 "startIndex": {
                     "format": "int32",
                     "type": "integer"
@@ skipping 43 matching lines @@
                     "type": "integer"
                 },
                 "purchaseTimeMillis": {
                     "description": "The time the product was purchased, in milliseconds since the epoch (Jan 1, 1970).",
                     "format": "int64",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "Season": {
+            "id": "Season",
+            "properties": {
+                "end": {
+                    "$ref": "MonthDay",
+                    "description": "Inclusive end date of the recurrence period."
+                },
+                "start": {
+                    "$ref": "MonthDay",
+                    "description": "Inclusive start date of the recurrence period."
+                }
+            },
+            "type": "object"
+        },
+        "SubscriptionDeferralInfo": {
+            "description": "A SubscriptionDeferralInfo contains the data needed to defer a subscription purchase to a future expiry time.",
+            "id": "SubscriptionDeferralInfo",
+            "properties": {
+                "desiredExpiryTimeMillis": {
+                    "description": "The desired next expiry time for the subscription in milliseconds since Epoch. The given time must be after the current expiry time for the subscription.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "expectedExpiryTimeMillis": {
+                    "description": "The expected expiry time for the subscription. If the current expiry time for the subscription is not the value specified here, the deferral will not occur.",
+                    "format": "int64",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "SubscriptionPurchase": {
             "description": "A SubscriptionPurchase resource indicates the status of a user's subscription purchase.",
             "id": "SubscriptionPurchase",
             "properties": {
                 "autoRenewing": {
                     "description": "Whether the subscription will automatically be renewed when it reaches its current expiry time.",
                     "type": "boolean"
                 },
                 "expiryTimeMillis": {
                     "description": "Time at which the subscription will expire, in milliseconds since Epoch.",
                     "format": "int64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "androidpublisher#subscriptionPurchase",
                     "description": "This kind represents a subscriptionPurchase object in the androidpublisher service.",
                     "type": "string"
                 },
                 "startTimeMillis": {
                     "description": "Time at which the subscription was granted, in milliseconds since Epoch.",
                     "format": "int64",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "SubscriptionPurchasesDeferRequest": {
+            "id": "SubscriptionPurchasesDeferRequest",
+            "properties": {
+                "deferralInfo": {
+                    "$ref": "SubscriptionDeferralInfo",
+                    "description": "The information about the new desired expiry time for the subscription."
+                }
+            },
+            "type": "object"
+        },
+        "SubscriptionPurchasesDeferResponse": {
+            "id": "SubscriptionPurchasesDeferResponse",
+            "properties": {
+                "newExpiryTimeMillis": {
+                    "description": "The new expiry time for the subscription in milliseconds since the Epoch.",
+                    "format": "int64",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Testers": {
             "id": "Testers",
             "properties": {
                 "googleGroups": {
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "googlePlusCommunities": {
@@ skipping 52 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "androidpublisher/v2/applications/",
     "title": "Google Play Android Developer API",
     "version": "v2"
 }