Merchant Accounts API 출시 노트

2025년 8월 25일 주간

  • Regions API에 새로운 일괄 메서드가 추가되었습니다.
    • BatchCreateRegions: 단일 요청에서 여러 리전을 만들 수 있습니다.
    • BatchUpdateRegions: 단일 요청에서 여러 리전을 업데이트할 수 있습니다.
    • BatchDeleteRegions: 단일 요청에서 이름으로 여러 리전을 삭제하는 기능을 제공합니다.

2025년 7월 1일 주

  • API 사용자가 checkoutSettings를 생성, 업데이트, 삭제, 가져올 수 있도록 하는 CheckoutSettings 리소스 출시

2025년 5월 26일 주

  • 이제 capabilities별로 계정을 필터링할 수 있습니다. 현재 가능한 값은 CAN_UPLOAD_PRODUCTS뿐입니다. 이 필터를 사용하면 제품을 업로드할 수 있는 계정을 검색할 수 있습니다. 이제 계정 수준에서 다음 절을 사용할 수 있습니다.

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS 자세한 내용은 필터링 가이드를 참고하세요.

  • 읽기 전용 액세스 권한 출시 읽기 전용 액세스 권한이 있는 사용자는 판매자 데이터를 볼 수 있지만 수정할 수는 없습니다.

2025년 5월 19일 주

  • 프로그램 API의 문서를 업데이트하여 Enable/Disable 메서드가 관리자 사용자에게만 제한된다는 잘못된 설명을 삭제했습니다.

2025년 5월 12일 주

  • API 사용자가 반품 정책을 생성, 업데이트, 삭제할 수 있는 온라인 반품 정책 리소스 출시
  • API 사용자가 옴니채널 환경을 관리할 수 있는 OmnichannelSettingsService 및 OmnichannelSetting 리소스 출시
  • API 사용자가 로컬 피드 파트너십 관계를 관리할 수 있는 LfpProvidersService 및 LfpProvider 리소스 출시
  • API 사용자가 Google 비즈니스 프로필을 관리할 수 있는 GbpAccountsService 및 GbpAccount 리소스 출시
    • 오프라인 판매점 인벤토리 광고 또는 무료 오프라인 등록정보에 사용되는 비즈니스 그룹을 연결하는 AccountService에서 서비스 유형 LocalListingManagement를 실행합니다.

2025년 4월 28일 주간

  • API 사용자가 관계를 관리하고 서비스 제공업체에 서비스를 설정할 수 있는 AccountService 및 AccountRelationship 리소스 출시

2025년 4월 14일 주간

  • 이제 TermsOfServiceService.AcceptTermsOfService은 수락된 TermsOfServiceAgremeentState을 응답 유형으로 래핑하여 반환합니다.

  • TermsOfServiceService.AcceptTermsOfService 작업의 동사가 이제 POST입니다 (이전에는 GET였음).

  • AccountsService.ListSubAccounts는 providers/...가 아닌 accounts/... 형식을 사용하여 호출해야 한다고 명시했습니다. 이는 이 메서드가 accounts 범위(즉, GET providers/123:listSubAccounts이 아닌 GET accounts/123:listSubAccounts)에서 벗어나지 않도록 하기 위해서입니다.

2025년 3월 31일 주

  • 계정 필터링의 경우 externalAccountId 필터가 2024년 12월 2일 주에 지원 중단된다고 발표되었으며 현재는 사용할 수 없습니다. 즉, 이제 externalAccountId별 필터링은 service 수준에서만 가능합니다. relationship(externalAccountId = "foo")와 같은 필터는 더 이상 작동하지 않으며 relationship(service(externalAccountId = "foo"))로 표현해야 합니다.

  • AccountsService 문서에서 독립형 계정을 만들 수 없다고 명시했습니다.

2025년 3월 3일 주간

- 명확성과 일관성을 개선하기 위해 accounts.onlineReturnPolicies#SeasonalOverride이 리팩터링되었습니다. 업데이트에 포함되는 내용은 다음과 같습니다.

  • 필드 이름 변경:
    • begin는 이제 start_date입니다.
    • end는 이제 end_date입니다.
  • 필드 삭제:
    • 지원 중단된 policy 필드가 삭제되었습니다.

-개발자는 이러한 변경사항을 반영하도록 코드를 업데이트해야 합니다.

다음을 관리하는 데 사용할 수 있는 AutomaticImprovements 서비스 출시

자세한 내용은 자동 개선 사용 설정을 참고하세요.

2025년 2월 17일 주

계정 필터에서 callerHasAccessToProviderFilter() 술어를 삭제했습니다.

2025년 2월 10일 주간

  • AccountsService.List 메서드 문서가 개선되었습니다. 독립형 계정뿐만 아니라 사용자가 액세스할 수 있는 모든 계정을 반환합니다.

  • 모든 RPC 메서드에 기본 기한 10분이 추가되었습니다.

  • 사용 가능한 프로그램 이름 목록이 accounts.programs 리소스 설명에 추가되었습니다.

  • 이제 User.accessRights이 REQUIRED이 되어 UserService.Create 및 AccountsService.CreateAndConfigure 메서드에 모두 영향을 미칩니다.

2025년 1월 27일 주

이제 AccountsService.ListAccounts (및 전이적으로 AccountsService.ListSubAccounts)는 강력한 읽기가 아닌 eventual consistency 방식으로 계정을 반환합니다.

2025년 1월 20일 주간

CreateAndConfigureAccountRequest의 users 필드는 새로운 user로 대체되어 지원 중단됩니다. 참조된 CreateUserRequest에 CreateAndConfigureAccountRequest 컨텍스트에서 필요하지 않은 parent 필드가 포함되어 있습니다.

2025년 1월 6일 주

이제 CreateUserRequest 메시지의 user 필드가 OPTIONAL로 올바르게 표시됩니다.

반환된 오류의 domain 필드가 이제 global 대신 merchantapi.googleapis.com로 채워집니다.

2024년 12월 2일 주간

계정 필터링의 경우 externalAccountId 조건자가 relationship 수준에서 service 수준으로 이동합니다. 따라서 이제 relationship(externalAccountId = "foo") 필터를 relationship(service(externalAccountId = "foo"))로 작성해야 합니다. 이전 형식은 이전 버전과의 호환성을 위해 계속 지원되지만 지원 중단되었으며 조만간 오류가 발생합니다. 모든 문서에서는 새 형식만 언급합니다.

2024년 11월 18일 주

이제 CreateAndConfigureAccountRequest.service.provider 필드의 제공업체는 providers/GOOGLE_ADS 또는 providers/GOOGLE_BUSINESS_PROFILE 중 하나일 수도 있습니다. 다른 계정은 accounts/123이 아닌 providers/123로 참조해야 합니다. 즉, 필드가 더 이상 계정 참조로 주석 처리되지 않습니다. 하지만 이전 버전과의 호환성을 위해 accounts/123와 같은 계정 이름을 계속 사용할 수도 있습니다.

이제 ListSubAccountsRequest의 제공자는 providers/123 형식이어야 하지만 이전 버전과의 호환성을 위해 accounts/123를 계속 사용할 수 있습니다.

2024년 11월 4일 주

BusinessIdentity 리소스에서 promotions_consent REQUIRED (OPTIONAL에서)을 표시합니다. 이는 업데이트 메서드에만 영향을 미칩니다. 이는 promotions_consent를 UNSPECIFIED로 업데이트할 수 없음을 명확히 하기 위한 것입니다. 이는 이미 불가능했지만 이제 오류가 더 설명적이고 필드가 올바르게 주석 처리됩니다.

2024년 10월 28일 주간

User, Homepage, BusinessInfo 등 계정 하위 API의 다양한 리소스에 관한 문서를 개선합니다.

2024년 10월 21일 주

업데이트 요청의 update_mask 필드에 대한 문서를 개선하여 업데이트가 지원되는 필드를 구체적으로 지적합니다.

지원되는 이동통신사의 Google 비즈니스 고객센터 링크를 ShippingSettings 리소스의 외부 문서에 추가

2024년 10월 14일 주

AccountsService.CreateAndConfigureAccountRequest.AddAccountService에서 provider를 REQUIRED로 표시합니다.

계정 하위 API (예: 비즈니스 ID, 비즈니스 정보, 홈페이지 등) 전체에서 update_mask를 선택사항으로 만들고 ConversionSources 리소스에 대해 소급 적용합니다.

ClaimHomepageRequest에 overwrite 매개변수를 추가했습니다.

2024년 9월 30일 주

'Accounts.delete' 메서드의 'force' 매개변수 출시

2024년 9월 23일 주간

RetrieveLatestTermsOfServiceRequest에서 region_code 및 kind를 REQUIRED로 표시

2024년 9월 16일 주

ListAccountIssuesRequest에서 time_zone 매개변수의 유형을 문자열로 변경했습니다.

2024년 8월 12일 주간

BusinessInfo 리소스에 korean_business_registration_number 필드를 추가했습니다.

2024년 5월 27일 주

계정 하위 API 베타 출시