Google Ads là công cụ mạnh mẽ giúp doanh nghiệp quảng cáo trực tuyến hiệu quả. Tuy nhiên, để tận dụng tối đa sức mạnh của Google Ads API, bạn cần thiết lập cấu hình OAuth phù hợp. OAuth là giao thức ủy quyền an toàn, giúp ứng dụng của bạn tương tác với Google Ads mà không cần sự can thiệp trực tiếp của người dùng. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách định cấu hình thư viện ứng dụng cho OAuth và tài khoản dịch vụ, giúp quá trình xử lý lệnh gọi API Google Ads trở nên dễ dàng và nhanh chóng hơn.
Sau khi đã nắm rõ các yêu cầu cấu hình, bạn có thể tiến hành thiết lập thư viện ứng dụng để xử lý các lệnh gọi API Google Ads. Mỗi thư viện ứng dụng sẽ có cách cấu hình khác nhau, vì vậy bạn cần làm theo hướng dẫn chi tiết tương ứng với ngôn ngữ lập trình mà bạn đang sử dụng.
Các ngôn ngữ phổ biến như java, .net, python, ruby, và perl đều có thư viện hỗ trợ tích hợp với API Google Ads. Đối với các luồng ứng dụng web và máy tính, bạn cần xác minh kỹ cấu hình của mình trước khi tiến hành.
Xác minh cấu hình của bạn
Sau khi hoàn tất việc thiết lập OAuth, bạn có thể thực hiện lệnh gọi API Google Ads bằng cách sử dụng một trong các đoạn mã ví dụ được cung cấp trong thư viện ứng dụng. Chúng tôi khuyến nghị bạn chọn một ví dụ đơn giản, chẳng hạn như GetCampaigns, để kiểm tra và xác nhận rằng quá trình thiết lập đã thành công.
Nếu gặp bất kỳ khó khăn nào trong quá trình này, hãy tham khảo hướng dẫn khắc phục sự cố. Các tài liệu này cung cấp nhiều mẹo hữu ích để giúp bạn gỡ lỗi và giải quyết các vấn đề thường gặp khi làm việc với API Google Ads.
Hướng dẫn này cung cấp cách thức truy cập vào API Google Ads thông qua việc sử dụng tài khoản dịch vụ.
Tài khoản dịch vụ là một loại tài khoản được gắn liền với ứng dụng của bạn, không phải với người dùng cuối. Nó cho phép các hoạt động tương tác từ máy chủ đến máy chủ giữa ứng dụng web và các dịch vụ của Google. Khi đó, ứng dụng của bạn sẽ thực hiện các lệnh gọi API của Google thay mặt cho tài khoản dịch vụ, do đó không cần sự tham gia trực tiếp của người dùng.
Lưu ý quan trọng: Tài khoản dịch vụ chỉ có thể mạo danh người dùng trong cùng một Google Workspace (sử dụng địa chỉ email thuộc Google Workspace đó). Quy trình OAuth2 sẽ được áp dụng cho tài khoản dịch vụ, giúp bạn không cần có sự cho phép trực tiếp từ người dùng, mà chỉ cần ứng dụng của bạn được cấu hình đúng cách là có thể truy cập.
Việc sử dụng tài khoản dịch vụ mang lại hai lợi ích chính:
- Quy trình ủy quyền truy cập vào API Google sẽ được cấu hình một lần duy nhất, giúp bạn tránh phải thực hiện lại các bước phức tạp liên quan đến các luồng OAuth2 khác, vốn yêu cầu sự tương tác của người dùng.
- OAuth2 cũng cho phép ứng dụng của bạn mạo danh người dùng khác trong trường hợp cần thiết.
Lưu ý quan trọng: Bạn nên ưu tiên sử dụng quy trình OAuth2 dành cho ứng dụng web hoặc máy tính thay vì tài khoản dịch vụ, trừ khi bạn cần một tính năng đặc thù của miền (Ví dụ: mạo danh người dùng). Các luồng ứng dụng web hoặc máy tính sẽ yêu cầu người dùng cấp quyền ban đầu để truy cập vào tài khoản, nhưng quy trình thiết lập sau đó sẽ đơn giản hơn.
Đối với ứng dụng OAuth2 dành cho máy tính, bạn có thể duy trì mã làm mới (không bao giờ hết hạn) để lấy mã truy cập mới bất cứ khi nào cần. Khi sử dụng một trong các thư viện ứng dụng hỗ trợ, bạn có thể ủy quyền cho ứng dụng của mình bằng cách điền đầy đủ thông tin vào tệp cấu hình.
Điều kiện tiên quyết
- Bạn cần sở hữu miền Google Workspace như mydomain.com hoặc mybusiness.com.
- Mã phát triển API Google Ads cùng với tài khoản thử nghiệm (không bắt buộc).
- Thư viện ứng dụng cho ngôn ngữ lập trình mà bạn đang sử dụng.
- Dự án Google API Console đã được cấu hình để sử dụng với API Google Ads.
- Tài khoản Google Ads có quyền truy cập vào tài khoản Google Ads mà bạn muốn quản lý. Google Ads không hỗ trợ sử dụng tài khoản dịch vụ nếu không có hành vi mạo danh người dùng.
Thiết lập quyền truy cập cho tài khoản dịch vụ
Vì hành vi mạo danh người dùng chỉ được kiểm soát ở cấp độ miền, nên khi sử dụng tài khoản dịch vụ với quy trình xác thực OAuth2 của Google, bạn cần phải đăng ký miền của mình với Google Workspace. Sau khi hoàn tất, ứng dụng của bạn và người dùng có thể mạo danh bất kỳ tài khoản nào trong miền đó.
- Bắt đầu bằng cách tạo tài khoản dịch vụ và tải xuống thông tin đăng nhập.
Lưu khoá tài khoản dịch vụ dưới định dạng JSON và ghi lại mã của tài khoản dịch vụ. - Chia sẻ mã tài khoản dịch vụ cùng với phạm vi API Google Ads (https://www.googleapis.com/auth/adwords) với quản trị viên miền của bạn.
Yêu cầu quản trị viên miền cấp quyền trên toàn miền cho tài khoản dịch vụ của bạn. - Nếu bạn là quản trị viên miền, hãy làm theo các hướng dẫn trong trung tâm trợ giúp.
Sau khi hoàn thành, bạn có thể sử dụng tài khoản dịch vụ để truy cập vào tài khoản Google Ads của mình thông qua quy trình xác thực OAuth2.
Cấu hình thư viện ứng dụng
Chọn ngôn ngữ lập trình của bạn bên dưới để xem hướng dẫn cấu hình thư viện ứng dụng.
Java, .NET, Python, Ruby, Perl: Quy trình xác thực tài khoản dịch vụ bằng OAuth.
Các mối lo ngại về bảo mật
Vì tài khoản dịch vụ có quyền uỷ quyền trên toàn miền Google Workspace của bạn, bạn cần bảo mật tệp khoá để đảm bảo rằng tài khoản dịch vụ chỉ có quyền truy cập vào các dịch vụ Google mà nó được cấp phép. Điều này đặc biệt quan trọng vì tài khoản dịch vụ có khả năng mạo danh bất kỳ người dùng nào trong miền.
Một phương pháp bảo mật tốt là chỉ cấp quyền truy cập cho tài khoản dịch vụ đối với các API Google cần thiết nhất. Đây là biện pháp ưu tiên nhằm giảm thiểu nguy cơ tiếp cận dữ liệu nếu tệp khoá của tài khoản dịch vụ bị xâm phạm.
Việc cấu hình OAuth và sử dụng tài khoản dịch vụ trong API Google Ads là bước quan trọng để đảm bảo quá trình tương tác giữa ứng dụng và Google diễn ra suôn sẻ. Bằng cách tuân thủ các hướng dẫn và lưu ý bảo mật, bạn có thể tối ưu hóa hoạt động của ứng dụng mà không lo về rủi ro bảo mật. Nếu bạn gặp bất kỳ khó khăn nào trong quá trình cấu hình hoặc cần sự hỗ trợ, hãy tham khảo tài liệu khắc phục sự cố hoặc liên hệ với Google để được giải đáp.
