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 (oluşturma, silme, alma, listeleme, yol) değiştirir. Daha fazla bilgi için Hesabınıza erişimi kontrol etme başlıklı makaleyi inceleyin.

Temel farklılıklar

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

• Özel kaynak: Bu, Merchant Center hesabınıza kimlerin erişebileceğini ve bu kullanıcıların 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 (ör. accounts/12345/users/[e-mail]) tanımlayın.
• me takma adı: Kimliği doğrulanmış kullanıcıya başvurmak için kaynak adında e-posta adresi yerine me takma adını kullanabilirsiniz. Örneğin, accounts/12345/users/me.
• Birleştirilmiş erişim hakları: Merchant API, Content API'deki boolean erişim alanlarını (örneğin, admin, reportingManager) tek bir tekrarlanabilir access_rights alanında birleştirir.
• Kullanıcı daveti ve doğrulama: 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, kullanıcının durumuyla ilgili API görünürlüğü sağlar. Bu görünürlük, Content API for Shopping'de kullanılamıyordu. Ekle ## İstekler

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

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

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

İstek açıklaması	Content API for Shopping	Merchant API
Bir hesap için kullanıcıları 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 ile 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ısı	accountId	account accounts/{account} içinde başlıyor
Kullanıcı tanımlayıcısı	AccountUser nesnesi içindeki email_address	email accounts/{account}/users/{email} içinde başlıyor

Yöntemler

Aşağıdaki tabloda, Content API for Shopping ile Merchant API arasındaki 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.update	Kullanıcının erişim haklarını günceller.
accounts.update	users.delete	Bir hesaptan kullanıcı 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 kaynak.
AccountUser.email_address	CreateUserRequest.user_id ve User.name kuruluşunun bir parçası	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, admin Boole alanını access_rights enum'ındaki ADMIN değeriyle değiştirir.
AccountUser.order_manager, AccountUser.payments_manager, 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. Örneğin, accounts/{account}/users/{email}.
Kullanılamıyor	User.state	Kullanıcının davetiyesinin durumunu (PENDING veya VERIFIED) gösterir.