Merchant Accounts API 출시 노트

2026년 10월 26일 주

  • accounts.homepage.unclaim 메서드 및 Homepage 리소스의 claimed 필드에 대한 문서를 명확히 했습니다. 계정이 고급 계정에서 홈페이지 소유권 주장을 상속하는 경우 unclaim는 성공 응답을 반환하지만 홈페이지는 소유권 주장이 유지됩니다. 계정 자체가 소유권 주장에서 제외되면 unclaim에서 FAILED_PRECONDITION 오류를 반환합니다.

2026년 9월 28일 주

  • 포인트 멤버십을 관리하는 데 사용할 수 있는 LoyaltyPrograms 서비스의 알파 출시입니다. 이 기능은 일부 판매자에게만 제공됩니다. 자세한 내용은 포인트 멤버십 개요를 참고하세요.

  • 읽기 전용 home_page_uri 필드를 accounts 리소스에 추가하여 매장 홈페이지의 URI를 반환합니다.

2026년 8월 3일 주

  • 'ucp_checkout_management'를 계정 서비스 리소스에 서비스 유형으로 추가했습니다. 참고: UCP 결제는 액세스가 제한된 기능입니다.
  • 'ucp-integration' 프로그램에 대한 지원이 추가되었습니다 (제한된 액세스).
  • 'ucp_integration' 서비스 약관 종류에 대한 지원이 추가되었습니다.

2026년 6월 29일 주

  • 계정 목록 엔드포인트에 사용되는 access 필터가 출시되었습니다. 이 기능을 사용하면 액세스 수준에 따라 계정을 필터링할 수 있으며, 가능한 값은 DIRECT, INDIRECT, ALL입니다. 기본 동작은 액세스 권한이 있는 모든 계정을 반환하는 것입니다. 자세한 내용은 액세스할 수 있는 계정 필터링을 참고하세요.

2026년 4월 20일 주

  • accounts.programs 리소스 설명에 사용 가능한 프로그램 이름 목록에 youtube-affiliate를 추가했습니다.
  • YouTube Shopping 제휴 프로그램 API를 사용 설정합니다. 신뢰할 수 있는 테스터에게 제공됩니다.

2026년 4월 6일 주

  • 승인 상태에 WAITING 상태가 추가되었습니다. 비교 쇼핑 서비스(CSS)의 경우 WAITING는 PENDING와 ESTABLISHED 사이의 전환 상태입니다. 계정이 새 CSS로 완전히 이전되기 전에 원래 CSS에서 필요한 정리 작업을 수행하는 데 시간이 필요한 경우에 사용됩니다.

2026년 3월 16일 주

  • Accounts API에 CreateTestAccount 메서드가 출시되었습니다. 이를 통해 개발자는 격리된 샌드박스와 같은 환경에서 작동하는 전용 테스트 계정을 프로그래매틱 방식으로 만들어 통합을 개발하고 테스트할 수 있는 안전한 공간을 제공할 수 있습니다.

2025년 11월 17일 주

  • CreateAndConfigureAccountRequest에서 이제 계정 설정 중에 구성할 수 있는 새로운 서비스를 제공합니다. AccountAggregation, AccountManagement, ComparisonShopping 중 하나만 지정해야 합니다. 또한 ProductsManagement 및 CampaignsManagement 서비스를 원하는 만큼 지정할 수 있습니다. 하지만 제공업체 및 외부 계정 ID가 동일한 서비스가 두 개 있어서는 안 됩니다.

  • 이제 AccountsService.CreateAndConfigure 메서드는 인증 메일 전송 여부를 제어하는 설정을 제공합니다.

  • CreateAndConfigureAccountRequest.AddAccountService에 이제 external_account_id 필드가 있습니다 (이 필드는 AccountService 리소스에 이미 있음). CampaignsManagement 및 ProductsManagement 서비스와 함께 지정할 수 있습니다.

  • AccountService 리소스에 ComparisonShopping 서비스를 추가했습니다. 자세한 내용은 https://support.google.com/merchants/answer/12653197을 참고하세요.

  • 이제 CreateAndConfigureAccountRequest의 setAlias 필드를 사용하여 계정 생성 중에 관계의 별칭을 설정할 수 있습니다.

  • 통화하는 사용자를 나타내는 User 리소스의 상태를 PENDING에서 VERIFIED로 업데이트할 수 있는 VerifySelf 메서드를 UserService에 추가했습니다.

  • 판매자가 반경 영역을 사용하여 지역을 만들 수 있도록 Regions API의 Region 페이로드에 새 radius_area 필드를 출시합니다.

2025년 11월 10일 주

  • Services API의 v1alpha 버전을 게시합니다.
  • 판매자가 제품 속성에 대한 조건부 필터링을 기반으로 피드의 하위 집합만 Google Ads 계정과 공유할 수 있도록 하는 Services API의 CampaignManagement 페이로드에 새 product_filters 필드를 출시합니다. 이 기능은 허용 목록에 추가된 기능으로, 일부 판매자만 사용할 수 있습니다.

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일 주

  • Enable/Disable 메서드가 관리자로 제한된다는 잘못된 문구를 삭제하여 프로그램 API 문서를 업데이트했습니다.

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일 주에 지원 중단된다고 발표되었으며 현재 사용할 수 없습니다. 즉, 이제 service 수준에서만 externalAccountId로 필터링할 수 있습니다. 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 등 Accounts 하위 API의 다양한 리소스에 관한 문서를 개선합니다.

2024년 10월 21일 주

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

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

2024년 10월 14일 주

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

Accounts 하위 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일 주

Accounts 하위 API 베타 출시