Дизайн API для службы списков пользователей Google Adwords - PullRequest
0 голосов
/ 18 декабря 2018

Я пытаюсь найти лучший способ создания оболочки RESTful API вокруг API AdWords.Служба списка пользователей Adwords принимает два операнда Add или Remove вместе с другими параметрами (такими как идентификатор учетной записи, идентификатор списка, контактная информация, такая как хэшированные электронные письма и т. Д.).

Полезные нагрузки и ответы для добавленияили удаление контактов из списка пользователей, по сути, идентичны (за исключением операндов, упомянутых ранее - конечно, в ответе не указывается, какой метод вы отправили, что является особенно плохим.

У меня вопрос, какой глагол действия я должениспользовать для методов Add и Remove, в моей обертке? POST кажется наиболее подходящим для Add, и хотя я рассмотрел DELETE для Remove, он не совсем подходит, так как яя не удаляю ресурс (ресурс будет списком пользователей), я просто изменяю его.

Должен ли я вместо этого использовать PUT? Или глагол не имеет значения с момента фактического обновления / изменения?списка пользователей обрабатывается самим API AdWords?

...