Merge pull request #96 from square/release/27.2.0.20230315

Generated PR for Release: 27.2.0.20230315

doc/api/booking-custom-attributes.md

@@ -256,8 +256,18 @@ CompletableFuture<BulkDeleteBookingCustomAttributesResponse> bulkDeleteBookingCu
 
 ```java
 Map<String, BookingCustomAttributeDeleteRequest> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
+BookingCustomAttributeDeleteRequest values0 = new BookingCustomAttributeDeleteRequest.Builder(
+        "booking_id8",
+        "key4")
+    .build();
+
+values.put("key0", values0);
+BookingCustomAttributeDeleteRequest values1 = new BookingCustomAttributeDeleteRequest.Builder(
+        "booking_id9",
+        "key5")
+    .build();
+
+values.put("key1", values1);
 
 BulkDeleteBookingCustomAttributesRequest body = new BulkDeleteBookingCustomAttributesRequest.Builder(
         values)
@@ -301,8 +311,24 @@ CompletableFuture<BulkUpsertBookingCustomAttributesResponse> bulkUpsertBookingCu
 
 ```java
 Map<String, BookingCustomAttributeUpsertRequest> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BookingCustomAttributeUpsertRequest values0 = new BookingCustomAttributeUpsertRequest.Builder(
+        "booking_id8",
+        customAttribute)
+    .build();
+
+values.put("key0", values0);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BookingCustomAttributeUpsertRequest values1 = new BookingCustomAttributeUpsertRequest.Builder(
+        "booking_id9",
+        customAttribute)
+    .build();
+
+values.put("key1", values1);
 
 BulkUpsertBookingCustomAttributesRequest body = new BulkUpsertBookingCustomAttributesRequest.Builder(
         values)

doc/api/bookings.md

@@ -69,6 +69,14 @@ bookingsApi.listBookingsAsync(null, null, null, null, null, null).thenAccept(res
 
 Creates a booking.
 
+The required input must include the following:
+
+- `Booking.location_id`,
+- `Booking.start_at`,
+- `Booking.team_member_id`
+- `Booking.AppointmentSegment.service_variation_id`
+- `Booking.AppointmentSegment.service_variation_version`
+
 To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.
 To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.
 

doc/api/catalog.md

@@ -163,16 +163,10 @@ List<String> taxIds = new LinkedList<>();
 taxIds.add("#SalesTax");
 
 List<CatalogObject> variations = new LinkedList<>();
-Money priceMoney = new Money.Builder()
-    .amount(150L)
-    .currency("USD")
-    .build();
-
 CatalogItemVariation itemVariationData = new CatalogItemVariation.Builder()
     .itemId("#Tea")
     .name("Mug")
     .pricingType("FIXED_PRICING")
-    .priceMoney(priceMoney)
     .build();
 
 CatalogObject variations0 = new CatalogObject.Builder(
@@ -204,16 +198,10 @@ List<String> taxIds = new LinkedList<>();
 taxIds.add("#SalesTax");
 
 List<CatalogObject> variations = new LinkedList<>();
-Money priceMoney = new Money.Builder()
-    .amount(250L)
-    .currency("USD")
-    .build();
-
 CatalogItemVariation itemVariationData = new CatalogItemVariation.Builder()
     .itemId("#Coffee")
     .name("Regular")
     .pricingType("FIXED_PRICING")
-    .priceMoney(priceMoney)
     .build();
 
 CatalogObject variations0 = new CatalogObject.Builder(
@@ -224,16 +212,10 @@ CatalogObject variations0 = new CatalogObject.Builder(
     .build();
 
 variations.add(variations0);
-Money priceMoney = new Money.Builder()
-    .amount(350L)
-    .currency("USD")
-    .build();
-
 CatalogItemVariation itemVariationData = new CatalogItemVariation.Builder()
     .itemId("#Coffee")
     .name("Large")
     .pricingType("FIXED_PRICING")
-    .priceMoney(priceMoney)
     .build();
 
 CatalogObject variations1 = new CatalogObject.Builder(
@@ -517,16 +499,10 @@ CatalogObject variations0 = new CatalogObject.Builder(
     .build();
 
 variations.add(variations0);
-Money priceMoney = new Money.Builder()
-    .amount(400L)
-    .currency("USD")
-    .build();
-
 CatalogItemVariation itemVariationData = new CatalogItemVariation.Builder()
     .itemId("#Cocoa")
     .name("Large")
     .pricingType("FIXED_PRICING")
-    .priceMoney(priceMoney)
     .build();
 
 CatalogObject variations1 = new CatalogObject.Builder(

doc/api/checkout.md

@@ -67,41 +67,23 @@ OrderLineItemAppliedDiscount appliedDiscounts0 = new OrderLineItemAppliedDiscoun
 
 appliedDiscounts.add(appliedDiscounts0);
 
-Money basePriceMoney = new Money.Builder()
-    .amount(1500L)
-    .currency("USD")
-    .build();
-
 OrderLineItem lineItems0 = new OrderLineItem.Builder(
         "2")
     .name("Printed T Shirt")
     .appliedTaxes(appliedTaxes)
     .appliedDiscounts(appliedDiscounts)
-    .basePriceMoney(basePriceMoney)
     .build();
 
 lineItems.add(lineItems0);
-Money basePriceMoney = new Money.Builder()
-    .amount(2500L)
-    .currency("USD")
-    .build();
-
 OrderLineItem lineItems1 = new OrderLineItem.Builder(
         "1")
     .name("Slim Jeans")
-    .basePriceMoney(basePriceMoney)
     .build();
 
 lineItems.add(lineItems1);
-Money basePriceMoney = new Money.Builder()
-    .amount(3500L)
-    .currency("USD")
-    .build();
-
 OrderLineItem lineItems2 = new OrderLineItem.Builder(
         "3")
     .name("Woven Sweater")
-    .basePriceMoney(basePriceMoney)
     .build();
 
 lineItems.add(lineItems2);
@@ -117,15 +99,9 @@ OrderLineItemTax taxes0 = new OrderLineItemTax.Builder()
 taxes.add(taxes0);
 
 List<OrderLineItemDiscount> discounts = new LinkedList<>();
-Money amountMoney = new Money.Builder()
-    .amount(100L)
-    .currency("USD")
-    .build();
-
 OrderLineItemDiscount discounts0 = new OrderLineItemDiscount.Builder()
     .uid("56ae1696-z1e3-9328-af6d-f1e04d947gd4")
     .type("FIXED_AMOUNT")
-    .amountMoney(amountMoney)
     .scope("LINE_ITEM")
     .build();
 

doc/api/customer-custom-attributes.md

@@ -274,8 +274,24 @@ CompletableFuture<BulkUpsertCustomerCustomAttributesResponse> bulkUpsertCustomer
 
 ```java
 Map<String, BulkUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BulkUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest values0 = new BulkUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest.Builder(
+        "customer_id2",
+        customAttribute)
+    .build();
+
+values.put("key0", values0);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BulkUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest values1 = new BulkUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest.Builder(
+        "customer_id3",
+        customAttribute)
+    .build();
+
+values.put("key1", values1);
 
 BulkUpsertCustomerCustomAttributesRequest body = new BulkUpsertCustomerCustomAttributesRequest.Builder(
         values)

doc/api/devices.md

@@ -76,7 +76,7 @@ CompletableFuture<CreateDeviceCodeResponse> createDeviceCodeAsync(
 
 ```java
 DeviceCode deviceCode = new DeviceCode.Builder(
-        null)
+        "TERMINAL_API")
     .name("Counter 1")
     .locationId("B5E4484SHHNYH")
     .build();

doc/api/invoices.md

@@ -201,7 +201,7 @@ InvoiceFilter filter = new InvoiceFilter.Builder(
     .build();
 
 InvoiceSort sort = new InvoiceSort.Builder(
-        null)
+        "INVOICE_SORT_DATE")
     .order("DESC")
     .build();
 

doc/api/location-custom-attributes.md

@@ -253,9 +253,9 @@ CompletableFuture<BulkDeleteLocationCustomAttributesResponse> bulkDeleteLocation
 
 ```java
 Map<String, BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequest> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
-values.put("", values2);
+values.put("id1", values0);
+values.put("id2", values1);
+values.put("id3", values2);
 
 BulkDeleteLocationCustomAttributesRequest body = new BulkDeleteLocationCustomAttributesRequest.Builder(
         values)
@@ -302,8 +302,24 @@ CompletableFuture<BulkUpsertLocationCustomAttributesResponse> bulkUpsertLocation
 
 ```java
 Map<String, BulkUpsertLocationCustomAttributesRequestLocationCustomAttributeUpsertRequest> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BulkUpsertLocationCustomAttributesRequestLocationCustomAttributeUpsertRequest values0 = new BulkUpsertLocationCustomAttributesRequestLocationCustomAttributeUpsertRequest.Builder(
+        "location_id8",
+        customAttribute)
+    .build();
+
+values.put("key0", values0);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BulkUpsertLocationCustomAttributesRequestLocationCustomAttributeUpsertRequest values1 = new BulkUpsertLocationCustomAttributesRequestLocationCustomAttributeUpsertRequest.Builder(
+        "location_id9",
+        customAttribute)
+    .build();
+
+values.put("key1", values1);
 
 BulkUpsertLocationCustomAttributesRequest body = new BulkUpsertLocationCustomAttributesRequest.Builder(
         values)

doc/api/order-custom-attributes.md

@@ -267,8 +267,18 @@ CompletableFuture<BulkDeleteOrderCustomAttributesResponse> bulkDeleteOrderCustom
 
 ```java
 Map<String, BulkDeleteOrderCustomAttributesRequestDeleteCustomAttribute> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
+BulkDeleteOrderCustomAttributesRequestDeleteCustomAttribute values0 = new BulkDeleteOrderCustomAttributesRequestDeleteCustomAttribute.Builder(
+        "7BbXGEIWNldxAzrtGf9GPVZTwZ4F")
+    .key("cover-count")
+    .build();
+
+values.put("cover-count", values0);
+BulkDeleteOrderCustomAttributesRequestDeleteCustomAttribute values1 = new BulkDeleteOrderCustomAttributesRequestDeleteCustomAttribute.Builder(
+        "7BbXGEIWNldxAzrtGf9GPVZTwZ4F")
+    .key("table-number")
+    .build();
+
+values.put("table-number", values1);
 
 BulkDeleteOrderCustomAttributesRequest body = new BulkDeleteOrderCustomAttributesRequest.Builder(
         values)
@@ -319,8 +329,24 @@ CompletableFuture<BulkUpsertOrderCustomAttributesResponse> bulkUpsertOrderCustom
 
 ```java
 Map<String, BulkUpsertOrderCustomAttributesRequestUpsertCustomAttribute> values = new LinkedHashMap<>();
-values.put("", values0);
-values.put("", values1);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BulkUpsertOrderCustomAttributesRequestUpsertCustomAttribute values0 = new BulkUpsertOrderCustomAttributesRequestUpsertCustomAttribute.Builder(
+        customAttribute,
+        "order_id2")
+    .build();
+
+values.put("key0", values0);
+CustomAttribute customAttribute = new CustomAttribute.Builder()
+    .build();
+
+BulkUpsertOrderCustomAttributesRequestUpsertCustomAttribute values1 = new BulkUpsertOrderCustomAttributesRequestUpsertCustomAttribute.Builder(
+        customAttribute,
+        "order_id1")
+    .build();
+
+values.put("key1", values1);
 
 BulkUpsertOrderCustomAttributesRequest body = new BulkUpsertOrderCustomAttributesRequest.Builder(
         values)

doc/api/orders.md

@@ -49,15 +49,9 @@ CompletableFuture<CreateOrderResponse> createOrderAsync(
 
 ```java
 List<OrderLineItem> lineItems = new LinkedList<>();
-Money basePriceMoney = new Money.Builder()
-    .amount(1599L)
-    .currency("USD")
-    .build();
-
 OrderLineItem lineItems0 = new OrderLineItem.Builder(
         "1")
     .name("New York Strip Steak")
-    .basePriceMoney(basePriceMoney)
     .build();
 
 lineItems.add(lineItems0);
@@ -110,15 +104,9 @@ OrderLineItemDiscount discounts1 = new OrderLineItemDiscount.Builder()
     .build();
 
 discounts.add(discounts1);
-Money amountMoney = new Money.Builder()
-    .amount(100L)
-    .currency("USD")
-    .build();
-
 OrderLineItemDiscount discounts2 = new OrderLineItemDiscount.Builder()
     .uid("one-dollar-off")
     .name("Sale - $1.00 off")
-    .amountMoney(amountMoney)
     .scope("LINE_ITEM")
     .build();
 
@@ -211,27 +199,15 @@ CompletableFuture<CalculateOrderResponse> calculateOrderAsync(
 
 ```java
 List<OrderLineItem> lineItems = new LinkedList<>();
-Money basePriceMoney = new Money.Builder()
-    .amount(500L)
-    .currency("USD")
-    .build();
-
 OrderLineItem lineItems0 = new OrderLineItem.Builder(
         "1")
     .name("Item 1")
-    .basePriceMoney(basePriceMoney)
     .build();
 
 lineItems.add(lineItems0);
-Money basePriceMoney = new Money.Builder()
-    .amount(300L)
-    .currency("USD")
-    .build();
-
 OrderLineItem lineItems1 = new OrderLineItem.Builder(
         "2")
     .name("Item 2")
-    .basePriceMoney(basePriceMoney)
     .build();
 
 lineItems.add(lineItems1);