Merchant Accounts API 출시 노트

2026년 6월 29일 주간

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

2026년 4월 20일 주간

  • 사용 가능한 프로그램 이름 목록에 youtube-affiliate가 추가되었습니다. accounts.programs 리소스 설명
  • 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일 주간

  • 프로그램 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 수준에서만 가능합니다. A 필터(예: 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 술어가 service 수준에서 relationship 수준으로 이동합니다. 따라서 이제 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를 OPTIONAL에서 REQUIRED로 표시합니다. 이는 업데이트 메서드에만 영향을 미칩니다. 이는 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의 베타 버전이 출시되었습니다.