Trang này được dịch bởi Cloud Translation API.

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 thao tác 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 người dùng mới đăng ký trước. Ví dụ: nếu bạn đang dùng thử API lần đầu, thay vì thực hiện mọi lệnh gọi API với tư cách là Quản trị viên (chế độ mặc định cho địa chỉ email của bạn), bạn nên tạo một 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 thực tế.

Tạo một số địa chỉ Gmail mới, chẳng hạn như my.name.dfp.salesperson@gmail.com. Ngoài ra, bạn có thể đăng ký một địa chỉ hiện có không phải Gmail làm Tài khoản Google mới.
Gọi createUsers bằng địa chỉ mới đó và Role đã chọn.
Bạn có thể xác thực với tư cách 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ệ phân cấp đều phụ thuộc vào loại tài khoản của bạn (Doanh nghiệp nhỏ hoặc Đặc biệt). 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 gốc hiệu quả, hãy gọi NetworkService.getCurrentNetwork() và kiểm tra trường effectiveRootAdUnitId trên đối tượng Network được trả về.

Lưu ý: Các loại tài khoản khác nhau sẽ hỗ trợ các mẫu 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 cách sử dụng phương thức getObjectsByStatement() mà nhiều dịch vụ hiển thị, trong đó Object (Đối tượng) là một loại đối tượng cụ thể. Phương thức này nhận một truy vấn PQL, tương tự như truy vấn SQL trong đó phương thức này cho phép bạn chỉ định các trường cần tìm kiếm (nơi 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ừ cho kết quả tìm kiếm. Hãy xem Hướng dẫn về PQL để tìm hiểu thêm về PQL cũng như để tìm hiểu bạn có thể lọc theo trường đối tượng nào.

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

Để tạo một đơn đặt hàng, chỉ cần tạo đối tượng Order và đặt mã nhận dạng nhà quảng cáo, nhân viên bán hàng và nhà quản lý quảng cáo cho những người dùng thích hợp, chỉ định một tên riêng biệt và gọi createOrders(). Kết quả sẽ bao gồm Order mới tạo hoặc một 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ột mục hàng mới:

Tạo đối tượng Order mới hoặc sử dụng đối tượng hiện có.
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.
Tạo một đối tượng InventoryTargeting mới rồi chỉ định các đối tượng Placement hoặc AdUnit cần nhắm mục tiêu hoặc loại trừ.
Gói đối tượng InventoryTargeting của bạn bên trong một đối tượng Targeting mới và gán đối tượng đó cho thuộc tính nhắm mục tiêu của LineItem.
Gọi phương thức dịch vụ mục hàng createLineItems() bằng đối tượng mới và kiểm tra kết quả để xem liệu đối tượng của bạn đã được tạo hay chưa.

Ví dụ

Hãy 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 khác nhau sẽ hỗ trợ các thành phần khác nhau: ví dụ: mẫu quảng cáo hình ảnh hỗ trợ một tệp nguồn duy nhất cho hình ảnh; mẫu quảng cáo flash hỗ trợ 2 tệp tài sản cơ bản: tệp flash và tệp hình ảnh dự phòng, trong trường hợp không thể phân phát tệp flash. Đối với mẫu quảng cáo được lưu trữ trên trang web của bên thứ ba, bạn sẽ chỉ tải lên 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ể của bạn để tìm hiểu những thành phần mà bạn phải tải lên để tạo mẫu quảng cáo.

Ví dụ

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

Sửa đổi một đố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 đó bằng cách gọi getObjectsByStatement(), cập nhật giá trị trong các đối tượng được trả về rồi gọi updateObjects().

Lưu ý: Các đối tượng 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 quên đặt giá trị thuộc tính trong đối tượng bạn gửi, đối tượng đã lưu sẽ nhận được 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 của đố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 hiển thị. Phương thức này nhận 2 thông số:

Một thực thể của đối tượng hành động mô tả hành động bạn muốn thực hiện. Ví dụ: dịch vụ đặt hàng sẽ đưa ra một số thao tác, trong đó có ApproveOrders, PauseOrders và ArchiveOrders. Tất cả các đối tượng Hành động đều xuất phát từ một lớp hành động cơ sở phù hợp với dịch vụ của bạn.
Một truy vấn PQL mô tả đối tượng 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 lúc bằng cách chỉ định một câu lệnh PQL thích hợp.

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 mục Trung tâm trợ giúp về gắn thẻ để biết thêm thông tin.

Ví dụ khác

Bạn có thể tìm thấy nhiều ví dụ khác trong mã mẫu của thư viện ứng dụng bằng nhiều ngôn ngữ lập trình. Hãy xem trang Thư viện ứng dụng và mã mẫu để biết đường liên kết đến các ví dụ bằng ngôn ngữ lập trình của bạn.