feat: Add Create method to BasicReport

[kungfucraig]

Changes to the MC API required for Phase II.

[wfa-reviewable]

This change is 

[kungfucraig]

Reviewed 4 of 4 files at r1, 2 of 2 files at r3, all commit messages.
Reviewable status: complete! all files reviewed, all discussions resolved (waiting on @kungfucraig)

[SanjayVas]

Depends on #1993

[SanjayVas]

Reviewed 2 of 4 files at r1, 2 of 2 files at r3, all commit messages.
Reviewable status: all files reviewed, 2 unresolved discussions (waiting on @kungfucraig, @mariolamassaavedra, @stevenwarejones, and @tristanvuong2021)

---

src/main/proto/wfa/measurement/reporting/v2alpha/page.proto line 93 at r3 (raw file):

  // etc.)
  message BasicMetricSetSpec {
    // The reach

nit: describe the actual fields. The current descriptions imply that the fields contain result values. In general, I'd expect boolean fields here to start with "whether" and other fields to contain "if specified" or "if not specified"

Suggestion:

// Whether to include reach in the result

---

src/main/proto/wfa/measurement/reporting/v2alpha/basic_reports_service.proto line 144 at r3 (raw file):

  // The BasicReport to create.
  BasicReport basic_report = 3;

Shouldn't this also be [(google.api.field_behavior) = REQUIRED]?

[kungfucraig]

Reviewed 3 of 4 files at r4, 1 of 1 files at r5, all commit messages.
Reviewable status: all files reviewed, 2 unresolved discussions (waiting on @mariolamassaavedra, @SanjayVas, @stevenwarejones, and @tristanvuong2021)

---

src/main/proto/wfa/measurement/reporting/v2alpha/basic_reports_service.proto line 144 at r3 (raw file):

Previously, SanjayVas (Sanjay Vasandani) wrote…

Shouldn't this also be [(google.api.field_behavior) = REQUIRED]?

Done.

---

src/main/proto/wfa/measurement/reporting/v2alpha/page.proto line 93 at r3 (raw file):

Previously, SanjayVas (Sanjay Vasandani) wrote…

nit: describe the actual fields. The current descriptions imply that the fields contain result values. In general, I'd expect boolean fields here to start with "whether" and other fields to contain "if specified" or "if not specified"

That adds an awful lot of noise to the documentation. What do you think of this the updates I made instead?

[SanjayVas]

Reviewed 3 of 4 files at r4, 1 of 1 files at r5, all commit messages.
Reviewable status: all files reviewed, 1 unresolved discussion (waiting on @kungfucraig, @mariolamassaavedra, @stevenwarejones, and @tristanvuong2021)

---

src/main/proto/wfa/measurement/reporting/v2alpha/page.proto line 93 at r3 (raw file):

Previously, kungfucraig (Craig Wright) wrote…

That adds an awful lot of noise to the documentation. What do you think of this the updates I made instead?

I don't think it's terribly noisy, but this comment is also a nit

[stevenwarejones]

Reviewed 3 of 4 files at r4, 1 of 1 files at r5, all commit messages.
Reviewable status: complete! all files reviewed, all discussions resolved (waiting on @mariolamassaavedra and @tristanvuong2021)

[kungfucraig]

Reviewed 4 of 4 files at r7, 1 of 2 files at r8, 1 of 1 files at r9, all commit messages.
Reviewable status: complete! all files reviewed, all discussions resolved (waiting on @mariolamassaavedra and @tristanvuong2021)

[SanjayVas]

Reviewed 2 of 4 files at r7, 1 of 2 files at r8, 1 of 1 files at r9, all commit messages.
Reviewable status: all files reviewed, 3 unresolved discussions (waiting on @kungfucraig, @mariolamassaavedra, and @tristanvuong2021)

---

src/main/proto/wfa/measurement/reporting/v2alpha/page.proto line 62 at r9 (raw file):

  // and in the common template are supported.
  message Grouping {
    // A set field paths that indicate the dimensions to group by.

nit: Missing a word, but I think it's better to just drop the "set" since that sometimes implies unordered.

Suggestion:

Field

---

src/main/proto/wfa/measurement/reporting/v2alpha/page.proto line 160 at r9 (raw file):

    BasicMetricSetSpec basic = 1 [(google.api.field_behavior) = IMMUTABLE];

    // The unique reach of each item in reporting_unit.components

reporting_unit has type ReportingUnitMetricSetSpec which has no components field. Are you referring to a different reporting_unit field, such as the one in the parent PageSpec?

Code quote:

of each item in reporting_unit.components

---

src/main/proto/wfa/measurement/reporting/v2alpha/page.proto line 406 at r9 (raw file):

// See the definition of `ReportingImpressionQualificationFilter` for details
// on what it means for a filter to be active.
message PageResult {

Where is this used?