@google-shopping/lfp 0.5.0 → 0.7.0

package/README.md

@@ -122,14 +122,21 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 
 | Sample                      | Source Code                       | Try it |
 | --------------------------- | --------------------------------- | ------ |
-| Lfp_inventory_service.insert_lfp_inventory | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_inventory_service.insert_lfp_inventory.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_inventory_service.insert_lfp_inventory.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Lfp_merchant_state_service.get_lfp_merchant_state | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_merchant_state_service.get_lfp_merchant_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_merchant_state_service.get_lfp_merchant_state.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Lfp_sale_service.insert_lfp_sale | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_sale_service.insert_lfp_sale.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_sale_service.insert_lfp_sale.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Lfp_store_service.delete_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.delete_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.delete_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Lfp_store_service.get_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.get_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.get_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Lfp_store_service.insert_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.insert_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.insert_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Lfp_store_service.list_lfp_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.list_lfp_stores.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.list_lfp_stores.js,packages/google-shopping-merchant-lfp/samples/README.md) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/master/packages/google-shopping-merchant-lfp/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/quickstart.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_inventory_service.insert_lfp_inventory | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_inventory_service.insert_lfp_inventory.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_inventory_service.insert_lfp_inventory.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_merchant_state_service.get_lfp_merchant_state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_merchant_state_service.get_lfp_merchant_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_merchant_state_service.get_lfp_merchant_state.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_sale_service.insert_lfp_sale | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_sale_service.insert_lfp_sale.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_sale_service.insert_lfp_sale.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.delete_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.delete_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.delete_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.get_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.get_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.get_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.insert_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.insert_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.insert_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.list_lfp_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.list_lfp_stores.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1/lfp_store_service.list_lfp_stores.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_inventory_service.insert_lfp_inventory | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_inventory_service.insert_lfp_inventory.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_inventory_service.insert_lfp_inventory.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_merchant_state_service.get_lfp_merchant_state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_merchant_state_service.get_lfp_merchant_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_merchant_state_service.get_lfp_merchant_state.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_sale_service.insert_lfp_sale | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_sale_service.insert_lfp_sale.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_sale_service.insert_lfp_sale.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.delete_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.delete_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.delete_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.get_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.get_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.get_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.insert_lfp_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.insert_lfp_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.insert_lfp_store.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Lfp_store_service.list_lfp_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.list_lfp_stores.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/generated/v1beta/lfp_store_service.list_lfp_stores.js,packages/google-shopping-merchant-lfp/samples/README.md) |
+| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-shopping-merchant-lfp/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-shopping-merchant-lfp/samples/quickstart.js,packages/google-shopping-merchant-lfp/samples/README.md) |
 
 
 
@@ -178,7 +185,7 @@ More Information: [Google Cloud Platform Launch Stages][launch_stages]
 
 ## Contributing
 
-Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/master/CONTRIBUTING.md).
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
 
 Please note that this `README.md`, the `samples/README.md`,
 and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
@@ -190,7 +197,7 @@ to its templates in
 
 Apache Version 2.0
 
-See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/master/LICENSE)
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 
 [client-docs]: https://cloud.google.com/nodejs/docs/reference/merchantapi/latest
 [product-docs]: https://developers.google.com/merchant/api

package/build/protos/google/shopping/merchant/lfp/v1/lfpinventory.proto

@@ -0,0 +1,152 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.shopping.merchant.lfp.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/shopping/type/types.proto";
+
+option csharp_namespace = "Google.Shopping.Merchant.Lfp.V1";
+option go_package = "cloud.google.com/go/shopping/merchant/lfp/apiv1/lfppb;lfppb";
+option java_multiple_files = true;
+option java_outer_classname = "LfpInventoryProto";
+option java_package = "com.google.shopping.merchant.lfp.v1";
+option php_namespace = "Google\\Shopping\\Merchant\\Lfp\\V1";
+option ruby_package = "Google::Shopping::Merchant::Lfp::V1";
+option (google.api.resource_definition) = {
+  type: "merchantapi.googleapis.com/Account"
+  pattern: "accounts/{account}"
+};
+
+// Service for a [LFP
+// partner](https://support.google.com/merchants/answer/7676652) to submit local
+// inventories for a merchant.
+service LfpInventoryService {
+  option (google.api.default_host) = "merchantapi.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/content";
+
+  // Inserts a `LfpInventory` resource for the given target merchant account. If
+  // the resource already exists, it will be replaced. The inventory
+  // automatically expires after 30 days.
+  rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory) {
+    option (google.api.http) = {
+      post: "/lfp/v1/{parent=accounts/*}/lfpInventories:insert"
+      body: "lfp_inventory"
+    };
+  }
+}
+
+// Local Inventory for the merchant.
+message LfpInventory {
+  option (google.api.resource) = {
+    type: "merchantapi.googleapis.com/LfpInventory"
+    pattern: "accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}"
+    plural: "lfpInventories"
+    singular: "lfpInventory"
+  };
+
+  // Output only. Identifier. The name for the `LfpInventory` resource.
+  // Format:
+  // `accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}`
+  string name = 1 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.field_behavior) = IDENTIFIER
+  ];
+
+  // Required. The Merchant Center ID of the merchant to submit the inventory
+  // for.
+  int64 target_account = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The identifier of the merchant's store. Either the store code
+  // inserted through `InsertLfpStore` or the store code in the Business
+  // Profile.
+  string store_code = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Immutable. A unique identifier for the product. If both
+  // inventories and sales are submitted for a merchant, this id should match
+  // for the same product.
+  //
+  // **Note**: if the merchant sells the same product new and used, they should
+  // have different IDs.
+  string offer_id = 4 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = IMMUTABLE
+  ];
+
+  // Required. The [CLDR territory
+  // code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml)
+  // for the country where the product is sold.
+  string region_code = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The two-letter ISO 639-1 language code for the item.
+  string content_language = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The Global Trade Item Number of the product.
+  optional string gtin = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The current price of the product.
+  google.shopping.type.Price price = 8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Availability of the product at this store.
+  // For accepted attribute values, see the [local product inventory data
+  // specification](https://support.google.com/merchants/answer/3061342)
+  string availability = 9 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Quantity of the product available at this store. Must be greater
+  // than or equal to zero.
+  optional int64 quantity = 10 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The time when the inventory is collected. If not set, it will be
+  // set to the time when the inventory is submitted.
+  google.protobuf.Timestamp collection_time = 11
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Supported pickup method for this offer. Unless the value is "not
+  // supported", this field must be submitted together with `pickupSla`. For
+  // accepted attribute values, see the [local product inventory data
+  // specification](https://support.google.com/merchants/answer/3061342).
+  optional string pickup_method = 12 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expected date that an order will be ready for pickup relative to
+  // the order date. Must be submitted together with `pickupMethod`. For
+  // accepted attribute values, see the [local product inventory data
+  // specification](https://support.google.com/merchants/answer/3061342).
+  optional string pickup_sla = 13 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The [feed
+  // label](https://developers.google.com/shopping-content/guides/products/feed-labels)
+  // for the product. If this is not set, it will default to `regionCode`.
+  optional string feed_label = 14 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for the `InsertLfpInventory` method.
+message InsertLfpInventoryRequest {
+  // Required. The LFP provider account.
+  // Format: `accounts/{account}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "merchantapi.googleapis.com/LfpInventory"
+    }
+  ];
+
+  // Required. The inventory to insert.
+  LfpInventory lfp_inventory = 2 [(google.api.field_behavior) = REQUIRED];
+}

package/build/protos/google/shopping/merchant/lfp/v1/lfpmerchantstate.proto

@@ -0,0 +1,209 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.shopping.merchant.lfp.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Shopping.Merchant.Lfp.V1";
+option go_package = "cloud.google.com/go/shopping/merchant/lfp/apiv1/lfppb;lfppb";
+option java_multiple_files = true;
+option java_outer_classname = "LfpMerchantStateProto";
+option java_package = "com.google.shopping.merchant.lfp.v1";
+option php_namespace = "Google\\Shopping\\Merchant\\Lfp\\V1";
+option ruby_package = "Google::Shopping::Merchant::Lfp::V1";
+
+// Service for a [LFP
+// partner](https://support.google.com/merchants/answer/7676652) to get the
+// state of a merchant.
+//
+// For information about onboarding a retailer, see [How to onboard a
+// retailer](https://support.google.com/merchants/answer/15243706).
+service LfpMerchantStateService {
+  option (google.api.default_host) = "merchantapi.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/content";
+
+  // Gets the LFP state of a merchant
+  rpc GetLfpMerchantState(GetLfpMerchantStateRequest)
+      returns (LfpMerchantState) {
+    option (google.api.http) = {
+      get: "/lfp/v1/{name=accounts/*/lfpMerchantStates/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+}
+
+// The LFP state of a merchant.
+message LfpMerchantState {
+  option (google.api.resource) = {
+    type: "merchantapi.googleapis.com/LfpMerchantState"
+    pattern: "accounts/{account}/lfpMerchantStates/{lfp_merchant_state}"
+    plural: "lfpMerchantStates"
+    singular: "lfpMerchantState"
+  };
+
+  // The state of a specific merchant's store.
+  message LfpStoreState {
+    // The state of matching `LfpStore` to a Google Business Profile listing.
+    enum StoreMatchingState {
+      // Store matching state unspecified.
+      STORE_MATCHING_STATE_UNSPECIFIED = 0;
+
+      // The `LfpStore` is successfully matched with a Google Business Profile
+      // store.
+      STORE_MATCHING_STATE_MATCHED = 1;
+
+      // The `LfpStore` is not matched with a Google Business Profile store.
+      STORE_MATCHING_STATE_FAILED = 2;
+    }
+
+    // Required. Immutable. The identifier of this store.
+    string store_code = 1 [
+      (google.api.field_behavior) = REQUIRED,
+      (google.api.field_behavior) = IMMUTABLE
+    ];
+
+    // Output only. The store matching state.
+    StoreMatchingState matching_state = 2
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // The hint of why the matching has failed (only set if matching_state is
+    // FAILED).
+    string matching_state_hint = 3;
+  }
+
+  // The inventory statistics for a merchant.
+  message InventoryStats {
+    // Number of entries (understanding entry as a pair of product and store)
+    // that were built based on provided inventories/sales and submitted to
+    // Google.
+    int64 submitted_entries = 1;
+
+    // Number of submitted in stock entries.
+    int64 submitted_in_stock_entries = 2;
+
+    // Number of entries that were built based on provided
+    // inventories/sales and couldn't be submitted to Google due to errors like
+    // missing product.
+    int64 unsubmitted_entries = 3;
+
+    // Number of products from provided inventories/sales that were created from
+    // matches to existing online products provided by the merchant or to the
+    // Google catalog.
+    int64 submitted_products = 4;
+  }
+
+  // Country-specific settings for the merchant.
+  message CountrySettings {
+    // The possible verification states for different merchant programs.
+    enum VerificationState {
+      // Verification state unspecified.
+      VERIFICATION_STATE_UNSPECIFIED = 0;
+
+      // Verification state not approved.
+      VERIFICATION_STATE_NOT_APPROVED = 1;
+
+      // Verification state in progress.
+      VERIFICATION_STATE_IN_PROGRESS = 2;
+
+      // Verification state approved.
+      VERIFICATION_STATE_APPROVED = 3;
+    }
+
+    // The possible [product page
+    // types](https://support.google.com/merchants/topic/15148370) for a
+    // merchant.
+    enum ProductPageType {
+      // Product page type unspecified.
+      PRODUCT_PAGE_TYPE_UNSPECIFIED = 0;
+
+      // Google hosted product page.
+      GOOGLE_HOSTED = 1;
+
+      // Merchant hosted product page.
+      MERCHANT_HOSTED = 2;
+
+      // Merchant hosted store specific product page.
+      MERCHANT_HOSTED_STORE_SPECIFIC = 3;
+    }
+
+    // Required. The [CLDR territory
+    // code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml)
+    // for the country for which these settings are defined.
+    string region_code = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // True if this merchant has enabled free local listings in MC.
+    bool free_local_listings_enabled = 2;
+
+    // True if this merchant has enabled local inventory ads in MC.
+    bool local_inventory_ads_enabled = 3;
+
+    // Output only. The verification state of this merchant's inventory check.
+    VerificationState inventory_verification_state = 4
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The product page type selected by this merchant.
+    ProductPageType product_page_type = 5
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The verification state of this merchant's instock serving
+    // feature.
+    VerificationState instock_serving_verification_state = 6
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The verification state of this merchant's pickup serving
+    // feature.
+    VerificationState pickup_serving_verification_state = 7
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Identifier. The name of the `LfpMerchantState` resource. Format:
+  // `accounts/{account}/lfpMerchantStates/{target_merchant}`. For example,
+  // `accounts/123456/lfpMerchantStates/567890`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Number of [GBPs](https://www.google.com/business/) this merchant has access
+  // to.
+  int64 linked_gbps = 2;
+
+  // Output only. The state per store from the specified merchant. The field
+  // will be absent if the merchant has no stores submitted through LFP.
+  repeated LfpStoreState store_states = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The inventory statistics for the merchant. The field will be absent if the
+  // merchant has no inventory submitted through LFP.
+  InventoryStats inventory_stats = 4;
+
+  // Country-specific settings for the merchant.
+  repeated CountrySettings country_settings = 5;
+}
+
+// Request message for the GetLfpMerchantState method.
+message GetLfpMerchantStateRequest {
+  // Required. The name of the state to retrieve.
+  // Format: `accounts/{account}/lfpMerchantStates/{target_merchant}`. For
+  // example, `accounts/123456/lfpMerchantStates/567890`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "merchantapi.googleapis.com/LfpMerchantState"
+    }
+  ];
+}

package/build/protos/google/shopping/merchant/lfp/v1/lfpsale.proto

@@ -0,0 +1,125 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.shopping.merchant.lfp.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/field_info.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/shopping/type/types.proto";
+
+option csharp_namespace = "Google.Shopping.Merchant.Lfp.V1";
+option go_package = "cloud.google.com/go/shopping/merchant/lfp/apiv1/lfppb;lfppb";
+option java_multiple_files = true;
+option java_outer_classname = "LfpSaleProto";
+option java_package = "com.google.shopping.merchant.lfp.v1";
+option php_namespace = "Google\\Shopping\\Merchant\\Lfp\\V1";
+option ruby_package = "Google::Shopping::Merchant::Lfp::V1";
+
+// Service for a [LFP
+// partner](https://support.google.com/merchants/answer/7676652) to submit sales
+// data for a merchant.
+service LfpSaleService {
+  option (google.api.default_host) = "merchantapi.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/content";
+
+  // Inserts a `LfpSale` for the given merchant.
+  rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale) {
+    option (google.api.http) = {
+      post: "/lfp/v1/{parent=accounts/*}/lfpSales:insert"
+      body: "lfp_sale"
+    };
+  }
+}
+
+// A sale for the merchant.
+message LfpSale {
+  option (google.api.resource) = {
+    type: "merchantapi.googleapis.com/LfpSale"
+    pattern: "accounts/{account}/lfpSales/{sale}"
+    plural: "lfpSales"
+    singular: "lfpSale"
+  };
+
+  // Output only. Identifier. The name of the `LfpSale` resource.
+  // Format:
+  // `accounts/{account}/lfpSales/{sale}`
+  string name = 1 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.field_behavior) = IDENTIFIER
+  ];
+
+  // Required. The Merchant Center ID of the merchant to submit the sale for.
+  int64 target_account = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The identifier of the merchant's store. Either a `storeCode`
+  // inserted through the API or the code of the store in the Business Profile.
+  string store_code = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A unique identifier for the product. If both inventories and
+  // sales are submitted for a merchant, this id should match for the same
+  // product.
+  //
+  // **Note**: if the merchant sells the same product new and used, they should
+  // have different IDs.
+  string offer_id = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The [CLDR territory
+  // code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml)
+  // for the country where the product is sold.
+  string region_code = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The two-letter ISO 639-1 language code for the item.
+  string content_language = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Global Trade Item Number of the sold product.
+  string gtin = 7 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The unit price of the product.
+  google.shopping.type.Price price = 8 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The relative change of the available quantity. Negative for items
+  // returned.
+  int64 quantity = 9 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The timestamp for the sale.
+  google.protobuf.Timestamp sale_time = 10
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. System generated globally unique ID for the `LfpSale`.
+  optional string uid = 11 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OUTPUT_ONLY
+  ];
+
+  // Optional. The [feed
+  // label](https://developers.google.com/shopping-content/guides/products/feed-labels)
+  // for the product. If this is not set, it will default to `regionCode`.
+  optional string feed_label = 12 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for the InsertLfpSale method.
+message InsertLfpSaleRequest {
+  // Required. The LFP provider account.
+  // Format: `accounts/{lfp_partner}`
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The sale to insert.
+  LfpSale lfp_sale = 2 [(google.api.field_behavior) = REQUIRED];
+}