계정 연결 이전

계정 관계 관리는 Content API for Shopping의 단일 link 메서드에서 Merchant API의 더 세부적이고 명시적인 시스템으로 발전했습니다. 새 API는 AccountRelationship 및 AccountService과 같은 전용 리소스를 사용하여 한 계정이 다른 계정에 제공하는 특정 서비스를 정의합니다. 자세한 내용은 계정 간 관계를 참고하세요.

주요 차이점

  • 관계 및 서비스를 위한 전용 리소스: Merchant API에서 AccountRelationship 리소스는 서비스 제공업체와 판매자 간의 연결을 정의하고 AccountService 리소스는 제공되는 정확한 서비스를 지정합니다 (예: accountAggregation). 이는 쇼핑용 Content API의 일반 linkType 및 services 필드를 대체합니다.
  • 명시적 작업 메서드: action 매개변수가 있는 단일 link 메서드 대신 Merchant API는 propose, approve, reject와 같은 서비스를 관리하는 데 별도의 메서드를 사용합니다.
  • 전용 Google 비즈니스 프로필 연결: 이전에는 googleMyBusinessLink 필드를 설정하여 처리했던 Google 비즈니스 프로필에 대한 연결에 이제 전용 메서드 gbpAccounts.linkGbpAccount이 있습니다.
  • 서비스로서의 클라이언트 계정 생성: 고급 계정에서 클라이언트 계정을 만드는 작업이 이제 accounts.createAndConfigure 메서드를 사용하여 accountAggregation 서비스를 제안하는 것으로 처리됩니다. 계정에 대한 자세한 내용은 Merchant Accounts API 페이지를 참고하세요. 사용자가 고급 계정과 고객 계정에 모두 액세스할 수 있으므로 핸드셰이크가 필요하지 않습니다.

요청

Merchant API는 다양한 유형의 계정 연결 및 서비스를 관리하기 위한 특정 엔드포인트를 제공합니다.

판매자 API 요청 URL

  • 새 서비스 제안: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • 서비스 승인: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • 서비스 거부: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Google 비즈니스 프로필 링크: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • 클라이언트 계정 만들기 (계정 집계 링크): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

요청 URL 비교

요청 설명 Content API for Shopping Merchant API
계정 연결 (예: 서드 파티 플랫폼) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Google 비즈니스 프로필에 연결 PUT .../v2.1/{merchantId}/accounts/{accountId} (googleMyBusinessLink 필드 사용) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
고객 계정 만들기 POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

메서드

Content API for Shopping 메서드 Merchant API 메서드 사용 가능 여부 및 참고사항
accounts.link accountServices.propose 이 메서드를 사용하여 다른 계정으로 새 서비스를 시작합니다.
accounts.link(action: "approve" 포함) accountServices.approve 이 메서드를 사용하여 대기 중인 서비스 제안을 승인합니다.
accounts.link(action: "remove" 포함) accountServices.reject 이 메서드를 사용하여 대기 중이거나 설정된 서비스를 거부합니다.
accounts.insert (고객 계정의 경우) accounts.createAndConfigure accountAggregation 서비스를 사용하여 고급 계정 아래에 새 고객 계정을 만들려면 이 메서드를 사용하세요.
accounts.update(googleMyBusinessLink 포함) gbpAccounts.linkGbpAccount 이 전용 방법을 사용하여 판매자 센터 계정을 Google 비즈니스 프로필에 연결하세요.
accounts.update(adsLinks 포함) 리소스 AccountRelationship개 Google Ads 연결은 Google Ads UI에서 관리됩니다. 결과 링크는 판매자 API에서 AccountRelationship로 표시되며, 직접 만들 수는 없지만 볼 수는 있습니다.

세부 필드 변경사항

Content API for Shopping Merchant API 설명
AccountsLinkRequest.action propose, approve, reject 메서드 단일 action 필드가 서비스 수명 주기의 각 상태 변경에 대한 전용 API 메서드로 대체됩니다.
AccountsLinkRequest.linkType AccountService.service_type 일반 linkType 문자열이 AccountService 리소스 내의 구조화된 service_type oneof 필드(예: productsManagement 또는 accountAggregation)로 대체됩니다.
AccountsLinkRequest.services AccountService.service_type 이제 문자열 기반 서비스 목록은 AccountService 리소스 내에서 선택한 특정 service_type로 표시됩니다.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider 이제 서비스를 제공하는 계정의 ID가 propose 요청의 provider 필드에 지정됩니다.
Account.googleMyBusinessLink LinkGbpAccountRequest GBP 링크 세부정보가 포함된 객체가 linkGbpAccount 메서드의 전용 요청 메시지로 대체됩니다.
Account.adsLinks AccountRelationship Google Ads 링크는 provider이 providers/GOOGLE_ADS인 AccountRelationship 리소스로 표시됩니다. 이 관계는 일반적으로 Google Ads UI에서 관리됩니다.