Release 2.20190710.0

CHANGES.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## Version 2.20190710.0 (2019-07-10)
+
+* **Breaking change** — As of 2019-07-10 Java Connect SDK does not support explicit `ENUM` types. Instead, the SDKs pass `ENUM` values as static `Strings`. Developer code can now choose to ignore unexpected `String` values when Square APIs return new values instead of being forced to throw runtime errors due to unexpected types. Additional information, including migration help, is available in the README.
+
+* **Retired functionality** — The `CatalogItem.image_url` field (deprecated under `Square-Version` YYYYMMDD) is retired and no longer included in Connect SDKs.
+
 ## Version 2.20190612.1 (2019-06-26)
 
 * **Bug fix**: `Transaction.Charge` and `Customers.CreateCustomerCard` request objects — now include the `verification_token` required for [Strong Customer Authentication](https://developer.squareup.com/docs/sca-overview).

README.md

@@ -2,6 +2,27 @@
 
 **If you have feedback about the new SDKs, or just want to talk to other Square Developers, request an invite to the new [slack community for Square Developers](https://squ.re/2GB8GHk)**
 
+## ENUM to String Migration
+The Java SDK no longer treats enums as explicit types. Instead, all enums are handled as static strings. 
+Previously, you would use an enum constant to represent the related string value. For example:
+```java
+Money money = new Money();
+money.setCurrency(Money.CurrencyEnum.USD);
+```
+
+As of version 2.20190710.0, you would work with the static string value directly. For example:
+```java
+Money money = new Money();
+money.setCurrency("USD");
+```
+
+But, as a best practice, we recommend representing enum strings as constants for easier reuse. For example:
+```java
+String MONEY_USD = "USD";
+Money money = new Money();
+money.setCurrency(MONEY_USD);
+```
+
 ## Requirements
 
 Java 8
@@ -18,7 +39,7 @@ Add this dependency to your project's POM:
 <dependency>
     <groupId>com.squareup</groupId>
     <artifactId>connect</artifactId>
-    <version>2.20190612.1</version>
+    <version>2.20190710.0</version>
     <scope>compile</scope>
 </dependency>
 ```
@@ -28,7 +49,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.squareup:connect:2.20190612.1"
+compile "com.squareup:connect:2.20190710.0"
 ```
 
 ### Option 3: Build and Install locally
@@ -70,7 +91,7 @@ At first generate the JAR by executing:
 
 Then manually install the following JARs:
 
-* target/connect-2.20190612.1.jar
+* target/connect-2.20190710.0.jar
 * target/lib/*.jar
 
 ## Getting Started
@@ -84,7 +105,6 @@ import com.squareup.connect.Configuration;
 import com.squareup.connect.api.LocationsApi;
 import com.squareup.connect.auth.OAuth;
 import com.squareup.connect.models.Location;
-import com.squareup.connect.models.Location.CapabilitiesEnum;
 
 import java.io.File;
 import java.util.*;
@@ -257,7 +277,6 @@ Class | Method | HTTP request | Description
  - [AdditionalRecipientReceivable](docs/AdditionalRecipientReceivable.md)
  - [AdditionalRecipientReceivableRefund](docs/AdditionalRecipientReceivableRefund.md)
  - [Address](docs/Address.md)
- - [AggregationStrategy](docs/AggregationStrategy.md)
  - [BatchChangeInventoryRequest](docs/BatchChangeInventoryRequest.md)
  - [BatchChangeInventoryResponse](docs/BatchChangeInventoryResponse.md)
  - [BatchDeleteCatalogObjectsRequest](docs/BatchDeleteCatalogObjectsRequest.md)

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'com.squareup'
-version = '2.20190612.1'
+version = '2.20190710.0'
 
 buildscript {
     repositories {

docs/Address.md

@@ -19,266 +19,10 @@ Name | Type | Description | Notes
 **administrativeDistrictLevel2** | **String** | A civil entity within the address's `administrative_district_level_1`. In the US, this is the county. |  [optional]
 **administrativeDistrictLevel3** | **String** | A civil entity within the address's `administrative_district_level_2`, if any. |  [optional]
 **postalCode** | **String** | The address's postal code. |  [optional]
-**country** | [**CountryEnum**](#CountryEnum) | The address's country, in ISO 3166-1-alpha-2 format. See [Country](#type-country) for possible values |  [optional]
+**country** | **String** | The address's country, in ISO 3166-1-alpha-2 format. See [Country](#type-country) for possible values |  [optional]
 **firstName** | **String** | Optional first name when it's representing recipient. |  [optional]
 **lastName** | **String** | Optional last name when it's representing recipient. |  [optional]
 **organization** | **String** | Optional organization name when it's representing recipient. |  [optional]
 
 
-<a name="CountryEnum"></a>
-## Enum: CountryEnum
-Name | Value
----- | -----
-ZZ | &quot;ZZ&quot;
-AD | &quot;AD&quot;
-AE | &quot;AE&quot;
-AF | &quot;AF&quot;
-AG | &quot;AG&quot;
-AI | &quot;AI&quot;
-AL | &quot;AL&quot;
-AM | &quot;AM&quot;
-AO | &quot;AO&quot;
-AQ | &quot;AQ&quot;
-AR | &quot;AR&quot;
-AS | &quot;AS&quot;
-AT | &quot;AT&quot;
-AU | &quot;AU&quot;
-AW | &quot;AW&quot;
-AX | &quot;AX&quot;
-AZ | &quot;AZ&quot;
-BA | &quot;BA&quot;
-BB | &quot;BB&quot;
-BD | &quot;BD&quot;
-BE | &quot;BE&quot;
-BF | &quot;BF&quot;
-BG | &quot;BG&quot;
-BH | &quot;BH&quot;
-BI | &quot;BI&quot;
-BJ | &quot;BJ&quot;
-BL | &quot;BL&quot;
-BM | &quot;BM&quot;
-BN | &quot;BN&quot;
-BO | &quot;BO&quot;
-BQ | &quot;BQ&quot;
-BR | &quot;BR&quot;
-BS | &quot;BS&quot;
-BT | &quot;BT&quot;
-BV | &quot;BV&quot;
-BW | &quot;BW&quot;
-BY | &quot;BY&quot;
-BZ | &quot;BZ&quot;
-CA | &quot;CA&quot;
-CC | &quot;CC&quot;
-CD | &quot;CD&quot;
-CF | &quot;CF&quot;
-CG | &quot;CG&quot;
-CH | &quot;CH&quot;
-CI | &quot;CI&quot;
-CK | &quot;CK&quot;
-CL | &quot;CL&quot;
-CM | &quot;CM&quot;
-CN | &quot;CN&quot;
-CO | &quot;CO&quot;
-CR | &quot;CR&quot;
-CU | &quot;CU&quot;
-CV | &quot;CV&quot;
-CW | &quot;CW&quot;
-CX | &quot;CX&quot;
-CY | &quot;CY&quot;
-CZ | &quot;CZ&quot;
-DE | &quot;DE&quot;
-DJ | &quot;DJ&quot;
-DK | &quot;DK&quot;
-DM | &quot;DM&quot;
-DO | &quot;DO&quot;
-DZ | &quot;DZ&quot;
-EC | &quot;EC&quot;
-EE | &quot;EE&quot;
-EG | &quot;EG&quot;
-EH | &quot;EH&quot;
-ER | &quot;ER&quot;
-ES | &quot;ES&quot;
-ET | &quot;ET&quot;
-FI | &quot;FI&quot;
-FJ | &quot;FJ&quot;
-FK | &quot;FK&quot;
-FM | &quot;FM&quot;
-FO | &quot;FO&quot;
-FR | &quot;FR&quot;
-GA | &quot;GA&quot;
-GB | &quot;GB&quot;
-GD | &quot;GD&quot;
-GE | &quot;GE&quot;
-GF | &quot;GF&quot;
-GG | &quot;GG&quot;
-GH | &quot;GH&quot;
-GI | &quot;GI&quot;
-GL | &quot;GL&quot;
-GM | &quot;GM&quot;
-GN | &quot;GN&quot;
-GP | &quot;GP&quot;
-GQ | &quot;GQ&quot;
-GR | &quot;GR&quot;
-GS | &quot;GS&quot;
-GT | &quot;GT&quot;
-GU | &quot;GU&quot;
-GW | &quot;GW&quot;
-GY | &quot;GY&quot;
-HK | &quot;HK&quot;
-HM | &quot;HM&quot;
-HN | &quot;HN&quot;
-HR | &quot;HR&quot;
-HT | &quot;HT&quot;
-HU | &quot;HU&quot;
-ID | &quot;ID&quot;
-IE | &quot;IE&quot;
-IL | &quot;IL&quot;
-IM | &quot;IM&quot;
-IN | &quot;IN&quot;
-IO | &quot;IO&quot;
-IQ | &quot;IQ&quot;
-IR | &quot;IR&quot;
-IS | &quot;IS&quot;
-IT | &quot;IT&quot;
-JE | &quot;JE&quot;
-JM | &quot;JM&quot;
-JO | &quot;JO&quot;
-JP | &quot;JP&quot;
-KE | &quot;KE&quot;
-KG | &quot;KG&quot;
-KH | &quot;KH&quot;
-KI | &quot;KI&quot;
-KM | &quot;KM&quot;
-KN | &quot;KN&quot;
-KP | &quot;KP&quot;
-KR | &quot;KR&quot;
-KW | &quot;KW&quot;
-KY | &quot;KY&quot;
-KZ | &quot;KZ&quot;
-LA | &quot;LA&quot;
-LB | &quot;LB&quot;
-LC | &quot;LC&quot;
-LI | &quot;LI&quot;
-LK | &quot;LK&quot;
-LR | &quot;LR&quot;
-LS | &quot;LS&quot;
-LT | &quot;LT&quot;
-LU | &quot;LU&quot;
-LV | &quot;LV&quot;
-LY | &quot;LY&quot;
-MA | &quot;MA&quot;
-MC | &quot;MC&quot;
-MD | &quot;MD&quot;
-ME | &quot;ME&quot;
-MF | &quot;MF&quot;
-MG | &quot;MG&quot;
-MH | &quot;MH&quot;
-MK | &quot;MK&quot;
-ML | &quot;ML&quot;
-MM | &quot;MM&quot;
-MN | &quot;MN&quot;
-MO | &quot;MO&quot;
-MP | &quot;MP&quot;
-MQ | &quot;MQ&quot;
-MR | &quot;MR&quot;
-MS | &quot;MS&quot;
-MT | &quot;MT&quot;
-MU | &quot;MU&quot;
-MV | &quot;MV&quot;
-MW | &quot;MW&quot;
-MX | &quot;MX&quot;
-MY | &quot;MY&quot;
-MZ | &quot;MZ&quot;
-NA | &quot;NA&quot;
-NC | &quot;NC&quot;
-NE | &quot;NE&quot;
-NF | &quot;NF&quot;
-NG | &quot;NG&quot;
-NI | &quot;NI&quot;
-NL | &quot;NL&quot;
-NO | &quot;NO&quot;
-NP | &quot;NP&quot;
-NR | &quot;NR&quot;
-NU | &quot;NU&quot;
-NZ | &quot;NZ&quot;
-OM | &quot;OM&quot;
-PA | &quot;PA&quot;
-PE | &quot;PE&quot;
-PF | &quot;PF&quot;
-PG | &quot;PG&quot;
-PH | &quot;PH&quot;
-PK | &quot;PK&quot;
-PL | &quot;PL&quot;
-PM | &quot;PM&quot;
-PN | &quot;PN&quot;
-PR | &quot;PR&quot;
-PS | &quot;PS&quot;
-PT | &quot;PT&quot;
-PW | &quot;PW&quot;
-PY | &quot;PY&quot;
-QA | &quot;QA&quot;
-RE | &quot;RE&quot;
-RO | &quot;RO&quot;
-RS | &quot;RS&quot;
-RU | &quot;RU&quot;
-RW | &quot;RW&quot;
-SA | &quot;SA&quot;
-SB | &quot;SB&quot;
-SC | &quot;SC&quot;
-SD | &quot;SD&quot;
-SE | &quot;SE&quot;
-SG | &quot;SG&quot;
-SH | &quot;SH&quot;
-SI | &quot;SI&quot;
-SJ | &quot;SJ&quot;
-SK | &quot;SK&quot;
-SL | &quot;SL&quot;
-SM | &quot;SM&quot;
-SN | &quot;SN&quot;
-SO | &quot;SO&quot;
-SR | &quot;SR&quot;
-SS | &quot;SS&quot;
-ST | &quot;ST&quot;
-SV | &quot;SV&quot;
-SX | &quot;SX&quot;
-SY | &quot;SY&quot;
-SZ | &quot;SZ&quot;
-TC | &quot;TC&quot;
-TD | &quot;TD&quot;
-TF | &quot;TF&quot;
-TG | &quot;TG&quot;
-TH | &quot;TH&quot;
-TJ | &quot;TJ&quot;
-TK | &quot;TK&quot;
-TL | &quot;TL&quot;
-TM | &quot;TM&quot;
-TN | &quot;TN&quot;
-TO | &quot;TO&quot;
-TR | &quot;TR&quot;
-TT | &quot;TT&quot;
-TV | &quot;TV&quot;
-TW | &quot;TW&quot;
-TZ | &quot;TZ&quot;
-UA | &quot;UA&quot;
-UG | &quot;UG&quot;
-UM | &quot;UM&quot;
-US | &quot;US&quot;
-UY | &quot;UY&quot;
-UZ | &quot;UZ&quot;
-VA | &quot;VA&quot;
-VC | &quot;VC&quot;
-VE | &quot;VE&quot;
-VG | &quot;VG&quot;
-VI | &quot;VI&quot;
-VN | &quot;VN&quot;
-VU | &quot;VU&quot;
-WF | &quot;WF&quot;
-WS | &quot;WS&quot;
-YE | &quot;YE&quot;
-YT | &quot;YT&quot;
-ZA | &quot;ZA&quot;
-ZM | &quot;ZM&quot;
-ZW | &quot;ZW&quot;
-
-