Cách hướng dẫn

Trang này cung cấp thông tin chi tiết về cách thực hiện các tác vụ phổ biến bằng API.

Tạo người dùng

UserService cho phép người dùng có quyền Quản trị viên để tạo người dùng ngay trong mạng của họ. Mọi nhà phát triển đều có thể thực hiện việc này mà không cần nhờ người dùng mới đăng ký trước. Ví dụ: nếu bạn đang thử dùng API cho thay vì thực hiện mọi lệnh gọi API với tư cách Quản trị viên (chế độ mặc định cho địa chỉ email của mình), bạn có thể tạo vài người dùng có vai trò như Nhân viên bán hàng, Người quản trị quảng cáo hoặc Nhà quảng cáo để thử nghiệm quy trình làm việc trong thực tế.

  1. Tạo một số địa chỉ Gmail mới như my.name.salesperson@gmail.com. Ngoài ra, đăng ký một địa chỉ không phải Gmail hiện có làm một địa chỉ mới Tài khoản Google.
  2. Gọi createUsers bằng địa chỉ mới đó và Role đã chọn.
  3. Bạn có thể xác thực là người dùng mới đó bằng cách sử dụng OAuth 2.0 để tạo mã truy cập.

Lấy đơn vị quảng cáo gốc

Cả AdUnit trên cùng mà bạn có thể thêm nút con và độ sâu được phép của hệ thống phân cấp đều phụ thuộc vào loại tài khoản của bạn (Doanh nghiệp nhỏ hay Cao cấp). AdUnit trên cùng hỗ trợ sửa đổi các nút con được gọi là AdUnit gốc hiệu quả.

Để truy xuất thư mục gốc có hiệu lực, hãy gọi NetworkService.getCurrentNetwork() và kiểm tra trường effectiveRootAdUnitId trên đối tượng Network được trả về.

Lưu ý: Mỗi loại tài khoản sẽ hỗ trợ các mô hình phân cấp khác nhau.

Truy vấn đối tượng

Bạn tìm kiếm đối tượng theo tiêu chí tìm kiếm bằng phương thức getObjectsByStatement() được hiển thị bởi nhiều dịch vụ, trong đó Object là một loại đối tượng cụ thể. Chiến dịch này sẽ lấy truy vấn PQL, tương tự như truy vấn SQL ở chỗ nó cho phép bạn chỉ định trường để tìm kiếm (trong đó tên trường ánh xạ đến các thuộc tính trên đối tượng), sắp xếp, giới hạn và bù trừ kết quả tìm kiếm của bạn. Xem PQL Hướng dẫn này để tìm hiểu thêm về PQL cũng như để tìm hiểu những trường đối tượng mà bạn có thể lọc theo.

Tạo đơn đặt hàng

Để tạo đơn đặt hàng, bạn chỉ cần tạo đối tượng Order rồi đặt nhà quảng cáo, nhân viên bán hàng và mã nhà quản lý quảng cáo cho người dùng thích hợp, chỉ định tên duy nhất, và gọi createOrders(). Kết quả sẽ bao gồm Order mới tạo, hoặc lỗi.

Ví dụ

Hãy xem ví dụ về Mã Java để tạo đơn đặt hàng.

Tạo mục hàng

Dưới đây là các bước để tạo mục hàng mới:

  1. Tạo đối tượng Order mới hoặc sử dụng đối tượng hiện có.
  2. Tạo đối tượng LineItem mới và đặt loại xoay vòng, mảng kích thước mẫu quảng cáo, ngày bắt đầu và ngày kết thúc cũng như các thuộc tính khác.
  3. Tạo một đối tượng InventoryTargeting mới và chỉ định các đối tượng Placement hoặc AdUnit cần nhắm mục tiêu hoặc loại trừ.
  4. Gói đối tượng InventoryTargeting bên trong đối tượng Targeting mới và gán vào thuộc tính nhắm mục tiêu của LineItem.
  5. Gọi phương thức dịch vụ mục hàng createLineItems() với đối tượng mới của bạn rồi kiểm tra kết quả để xem đối tượng của bạn đã được tạo hay chưa.

Ví dụ

Xem ví dụ về Mã Java để tạo mục hàng.

Tạo mẫu quảng cáo

Các loại mẫu quảng cáo sẽ hỗ trợ những thành phần khác nhau, ví dụ: một hình ảnh quảng cáo hỗ trợ một tệp nguồn duy nhất cho hình ảnh; quảng cáo flash hỗ trợ hai tệp nội dung cơ bản: một tệp flash và một tệp hình ảnh dự phòng, để phòng trường hợp flash Không thể cung cấp tệp. Đối với các mẫu quảng cáo được lưu trữ trên trang web của bên thứ ba, bạn sẽ tải chỉ một đoạn mã HTML tham chiếu đến tệp trên máy chủ của bên thứ ba. Xem lớp con Creative cụ thể để tìm hiểu những thành phần nào bạn sẽ phải tải lên theo thứ tự để tạo mẫu quảng cáo.

Ví dụ

Xem ví dụ về Mã Java để tạo mẫu quảng cáo dạng hình ảnh.

Sửa đổi đối tượng hiện có

Để sửa đổi một đối tượng hiện có, hãy truy vấn đối tượng của bạn bằng cách gọi getObjectsByStatement(), cập nhật các giá trị trong các đối tượng được trả về rồi gọi updateObjects().

Lưu ý: Các đối tượng được cập nhật sẽ thay thế hoàn toàn các đối tượng hiện có, vì vậy, nếu bạn không thiết lập giá trị thuộc tính trong đối tượng mà bạn gửi, đối tượng đã lưu sẽ lấy giá trị mặc định cho thuộc tính đó, chứ không phải giá trị trước đó.

Thay đổi trạng thái đối tượng

Trạng thái đối tượng sẽ thay đổi bằng cách gọi phương thức performObjectAction() mà dịch vụ của bạn sử dụng. Phương thức này nhận 2 tham số:

  • Một thực thể của đối tượng hành động mô tả việc bạn muốn thực hiện. Để Ví dụ: dịch vụ đặt hàng đưa ra một số hành động bao gồm ApproveOrders, PauseOrders, và ArchiveOrders. Các đối tượng thao tác đều bắt nguồn từ một thao tác cơ bản phù hợp với dịch vụ của bạn.
  • Truy vấn PQL mô tả đối tượng nào cần thay đổi. Bạn có thể thay đổi trạng thái của một hoặc nhiều đối tượng cùng một lúc bằng cách chỉ định PQL thích hợp tuyên bố.

Tạo thẻ quảng cáo

Bạn không thể tạo thẻ quảng cáo bằng API; thay vào đó bạn phải sử dụng trang web Google Ad Manager. Hãy xem phần Gắn thẻ Mục Trung tâm trợ giúp cho thông tin khác.

Ví dụ khác

Bạn có thể tìm thấy nhiều ví dụ khác trong mã mẫu thư viện ứng dụng của chúng tôi, trong ngôn ngữ lập trình khác nhau. Xem Thư viện ứng dụng & Mã ví dụ để có đường liên kết đến các ví dụ bằng ngôn ngữ lập trình của bạn.