Kullanıcı ve erişim yönetimini taşıma

Content API for Shopping'de, kullanıcıları ve erişim haklarını Account kaynağındaki bir alanla yönetiyordunuz. Merchant API, bu yöntemi User adlı özel kaynak ve ilgili yöntemlerle (create, delete, get, list, path) değiştirir. Daha fazla bilgi için Hesabınıza erişimi kontrol etme başlıklı makaleyi inceleyin.

Temel farklar

Merchant API, kullanıcı yönetimi konusunda Content API for Shopping'e kıyasla aşağıdaki avantajları sunar:

• Özel kaynak: Bu, Merchant Center hesabınıza kimlerin erişebileceğini ve neler yapabileceğini kontrol etmenin daha ayrıntılı ve doğrudan bir yolunu sunar.
• RESTful kaynak adları: Merchant API'de User kaynaklarını tam kaynak adıyla tanımlayın (ör. accounts/12345/users/example@example.com).
• me takma adı: Kimliği doğrulanmış kullanıcıyı belirtmek için kaynak adındaki e-posta adresi yerine me takma adını kullanabilirsiniz (ör. accounts/12345/users/me).
• Birleştirilmiş erişim hakları: Merchant API, Content API'deki boole erişim alanlarını (ör. admin, reportingManager) tek bir tekrarlanabilir access_rights alanında birleştirir.
• Kullanıcı daveti ve doğrulaması: Merchant API, açık bir kullanıcı durumu (PENDING veya VERIFIED) sunar. Yeni bir kullanıcı oluşturduğunuzda, daveti kabul edene kadar PENDING durumunda olur. Bu sayede, Content API for Shopping'de bulunmayan, kullanıcının durumuna ilişkin API görünürlüğü sağlanır. ## İstek ekleme

Merchant API, kullanıcıları yönetmek için aşağıdaki istek URL'lerini kullanır:

• GET /accounts/v1/accounts/{account}/users/{email}
• GET /accounts/v1/accounts/{account}/users
• POST /accounts/v1/accounts/{account}/users
• PATCH /accounts/v1/accounts/{account}/users/{email}
• DELETE /accounts/v1/accounts/{account}/users/{email}

Aşağıdaki tabloda, Content API for Shopping ve Merchant API'nin istek URL'leri karşılaştırılmaktadır.

İstek açıklaması	Content API for Shopping	Merchant API
Bir hesabın kullanıcılarını alma	GET {api_version}/{merchantId}/accounts/{accountId}	GET {api_version}/accounts/{account}/users
Kullanıcı oluşturma	PATCH {api_version}/{merchantId}/accounts/{accountId}	POST {api_version}/accounts/{account}/users
Kullanıcı güncelleme	PATCH {api_version}/{merchantId}/accounts/{accountId}	PATCH {api_version}/accounts/{account}/users/{email}
Kullanıcı silme	PATCH {api_version}/{merchantId}/accounts/{accountId}	DELETE {api_version}/accounts/{account}/users/{email}

Tanımlayıcılar

Aşağıdaki tabloda, Content API for Shopping ve Merchant API arasındaki isteklerde kullanılan tanımlayıcılar karşılaştırılmaktadır.

Tanımlayıcı açıklaması	Content API for Shopping	Merchant API
Hesap tanımlayıcı	accountId	accounts/{account} account
Kullanıcı kimliği	AccountUser nesnesindeki email_address	accounts/{account}/users/{email} email

Yöntemler

Aşağıdaki tabloda, Content API for Shopping ve Merchant API'deki yöntemler karşılaştırılmaktadır.

Content API for Shopping	Merchant API	Kullanılabilirlik ve notlar
accounts.update	users.create	Bir hesap için yeni kullanıcı oluşturur.
accounts.get	users.get	Tek bir kullanıcıyı alır.
accounts.get	users.list	Bir hesaptaki tüm kullanıcıları listeler.
accounts.update	users.patch	Kullanıcının erişim haklarını günceller.
accounts.update	users.delete	Bir kullanıcıyı hesaptan siler.

Ayrıntılı alan değişiklikleri

Alan kullanımınızı aşağıdaki gibi güncelleyin:

Content API for Shopping	Merchant API	Açıklama
users (AccountUser kez tekrarlandı)	users (User kez tekrarlandı)	User kaynağı artık kendi hizmetine sahip üst düzey bir kaynaktır.
AccountUser.email_address	CreateUserRequest.user_id ve User.name kapsamında	Kullanıcının e-posta adresi artık kaynak adının bir parçasıdır. Oluşturma sırasında user_id alanında belirtin.
AccountUser.admin	access_rights: "ADMIN"	Merchant API, Boole admin alanını access_rights enum'undaki ADMIN değeriyle değiştirir.
AccountUser.order_manager, AccountUser.payments_manager ve AccountUser.payments_analyst	access_rights: "STANDARD"	Merchant API, bu rolleri STANDARD erişim hakkıyla değiştirir.
AccountUser.reporting_manager	access_rights: "PERFORMANCE_REPORTING"	reporting_manager rolü artık PERFORMANCE_REPORTING erişim hakkı olarak adlandırılıyor.
AccountUser.read_only	access_rights: "READ_ONLY"	read_only rolü artık READ_ONLY erişim hakkı olarak adlandırılıyor.
Kullanılamıyor	User.name	Kullanıcının tam kaynak adını içerir (ör. accounts/{account}/users/{email}).
Kullanılamıyor	User.state	Kullanıcının davetinin durumunu (PENDING veya VERIFIED) gösterir.