CSS 제품 업데이트

UpdateCssProductInput 메서드를 사용하여 제품 cssProductInput.name와 제품에 대해 업데이트할 데이터가 포함된 JSON 본문을 지정하여 기존 단일 CSS 제품을 업데이트합니다.

참고: 이 메서드는 업데이트 요청에 제공된 속성만 업데이트합니다. 응답에는 요청과 동일한 속성이 포함되며 업데이트가 적용된 후의 전체 CssProductInput 상태가 반영되지 않습니다. CssProductInput의 최종 상태를 확인하기 위해 응답에 의존해서는 안 됩니다.

PATCH https://css.googleapis.com/v1/accounts/{ACCOUNT_ID}/cssProductInputs/{CSS_PRODUCT_ID}

제품의 속성을 추가하거나 수정하려면 JSON 본문에 새 값이 있는 필드를 지정합니다. 표시된 예시에서는 요청 본문에 제공된 속성 값으로 기존 제품 이름 123/cssProductInputs/de~DE~B019G4의 title 및 대표 상품 링크를 업데이트하고 다른 모든 필드는 그대로 둡니다.

HTTP

PATCH https://css.googleapis.com/v1/accounts/{ACCOUNT_ID}/cssProductInputs/{CSS_PRODUCT_ID}
{
  "attributes": {
    "title": "new item title",
    "headlineOfferLink": "headline-offer.com"
  }
}

cURL

curl --location --request PATCH 'https://css.googleapis.com/v1/accounts/{ACCOUNT_ID}/cssProductInputs/{CSS_PRODUCT_ID}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{"attributes":{"numberOfOffers":"99","headlineOfferPrice":{"currency_code":"EUR","amount_micros":"1200000"}}}'

자바

// Copyright 2023 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
//
//     https://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.

package shopping.css.samples.v1.cssproducts;

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.protobuf.FieldMask;
import com.google.shopping.css.v1.CssProductInput;
import com.google.shopping.css.v1.CssProductInputsServiceClient;
import com.google.shopping.css.v1.CssProductInputsServiceSettings;
import com.google.shopping.css.v1.UpdateCssProductInputRequest;
import shopping.css.samples.utils.Authenticator;
import shopping.css.samples.utils.Config;

/** This class demonstrates how to update a CSS Product for a given Account */
public class UpdateCssProductInput {

  private static String getName(String domainId, String productId) {
    return String.format("accounts/%s/cssProductInputs/%s", domainId, productId);
  }

  public static void updateCssProductInput(Config config, String productId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();
    String name = getName(config.getDomainId().toString(), productId);

    CssProductInputsServiceSettings cssProductInputsServiceSettings =
        CssProductInputsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (CssProductInputsServiceClient cssProductInputsServiceClient =
        CssProductInputsServiceClient.create(cssProductInputsServiceSettings)) {

      // Updates the title of the CSS Product leaving the rest of the fields unchanged
      UpdateCssProductInputRequest request =
          UpdateCssProductInputRequest.newBuilder()
              .setCssProductInput(
                  CssProductInput.newBuilder()
                      .setName(name)
                      .setAttributes(
                          com.google.shopping.css.v1.Attributes.newBuilder()
                              .setTitle("Attribute Title")
                              .setHeadlineOfferLink("abc.com")
                              .setHeadlineOfferCondition("New")
                              .setDescription("CSS Product description 0")
                              .build())
                      .build())
              .setUpdateMask(FieldMask.newBuilder().addPaths("title").build())
              .build();

      System.out.println("Updating CSS Product");
      CssProductInput response = cssProductInputsServiceClient.updateCssProductInput(request);
      System.out.print("CSS product updated:");

    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    final Config config = Config.load();

    // The ID uniquely identifying each product. In
    // the format languageCode~countryCode~rawProvidedId
    final String productId = "de~DE~rawProvidedId17";
    updateCssProductInput(config, productId);
  }
}

cssProductInputs.update 요청으로는 최상위 필드만 업데이트할 수 있습니다. 중첩된 필드를 업데이트하려면 전체 최상위 객체를 제공해야 합니다.

표시된 예시에서는 요청 본문에 제공된 제품 데이터로 기존 제품의 중첩된 필드를 포함한 최상위 headlineOfferPrice 객체를 업데이트하고 다른 모든 필드는 그대로 둡니다.

PATCH https://css.googleapis.com/v1/accounts/{ACCOUNT_ID}/cssProductInputs/{CSS_PRODUCT_ID}
{
  "attributes": {
    "headlineOfferPrice": {
      "amountMicros": "17.99",
      "currencyCode": "USD"
    }
  }
}

요청 본문에 포함된 다른 필드를 변경하지 않고 업데이트할 특정 필드를 선택하려면 updateMask를 지정하면 됩니다. 이 쿼리 문자열 파라미터는 수정해야 하는 필드의 쉼표로 구분된 목록이어야 합니다. updateMask는 명명된 필드만 업데이트됨을 어설션하려는 경우에 유용합니다. updateMask를 지정하지 않는 것은 예와 같이 요청의 모든 필드를 업데이트하도록 표시하는 것과 같습니다. 하지만 updateMask가 명시적으로 제공되지 않으면 기존 속성을 삭제할 수 없습니다.

표시된 예시에서는 요청 본문에 제공된 해당 제품 데이터로 기존 항목의 title만 업데이트하고 headline offer link를 비롯한 다른 모든 필드는 그대로 유지합니다.

PATCH https://css.googleapis.com/v1/accounts/{ACCOUNT_ID}/cssProductInputs/{CSS_PRODUCT_ID}?updateMask=title
{
  "attributes": {
    "title":"item-title",
    "headlineOfferLink":"headline-offer-newer.com"
  }
}

필드가 updateMask 목록에 제공되지만 요청 본문에는 제공되지 않는 경우 해당 필드는 Product 리소스에서 삭제됩니다(있는 경우).

표시된 예에서는 updateMask를 사용하여 title 필드의 값을 삭제합니다.

PATCH https://css.googleapis.com/v1/accounts/{ACCOUNT_ID}/cssProductInputs/{CSS_PRODUCT_ID}?updateMask=title

ACCOUNT_ID: 계정의 고유 식별자입니다(예: 123).

CSS_PRODUCT_ID: CSS 제품 ID입니다(예: de~DE~B019G4).

title 필드를 삭제하려면 요청 본문에서 제외하세요. 본문이 없거나 비어 있는 본문으로 요청을 보낼 수도 있습니다. updateMask에 없는 필드는 변경되지 않습니다.